# Create a Job

put ` https://app.mk.io/api/v1/projects/:project_name/media/transforms/:transform_name/jobs/:job_name`

Create a new Job.

RBAC Capability Required: `ams.job.create`

## Authentication

Authorization Bearer

Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Path parameters

- `project_name` string Required
- `transform_name` string Required
- `job_name` string Required

## Request

This endpoint expects an object.

properties object [JobPutProperties](https://docs.mediakind.com/api-reference/media-api/schemas/jobputproperties) Required

Properties of the job

1. correlationData map from strings to any (Optional)
   - Customer provided key, value pairs that will be returned in Job and JobOutput state events.
2. description string or null (Optional) <=1024 characters
   - The description of the Job.
3. input object Required  
   The inputs of the Job.

### Variants discriminated by `@odata.type`. Select one variant:

#### #Microsoft.Media.JobInputAsset object [JobInputAsset](https://docs.mediakind.com/api-reference/media-api/schemas/jobinputasset)
- `@odata.type` string Required
- `assetName` string Required
   - The name of the input Asset
- end object Optional
   - Defines a point on the timeline of the input media at which processing will end. Defaults to the end of the input media.

### Variants discriminated by `@odata.type`. Select one variant:
#### #Microsoft.Media.AbsoluteClipTime object [AbsoluteClipTime](https://docs.mediakind.com/api-reference/media-api/schemas/absolutecliptime)
- `@odata.type` string Required
- time string Optional
   - The time position in ISO8601 period. e.g PT30S for 30 seconds.

#### #Microsoft.Media.UtcClipTime object [UtcClipTime](https://docs.mediakind.com/api-reference/media-api/schemas/utccliptime)
- `@odata.type` string Required
- time string Optional
   - The time position based on UTC time.

- trigger object [ScteTrigger](https://docs.mediakind.com/api-reference/media-api/schemas/sctetrigger) Optional
   - SCTE-35 signal trigger. Recording starts/stops at the first matching signal.
 
- filters list of list of maps (Optional)
 
- searchRange object [ScteTriggerSearchRange](https://docs.mediakind.com/api-reference/media-api/schemas/sctetriggersearchrange) Optional
   - Bounds the signal search to `[anchor+startOffset, anchor+endOffset]`. Anchor is `time` if present, else dispatch_time (start) or resolved_start (end).
   - `endOffset` string Required
   - `startOffset` string Required
   - `signalType` enum Required
     - Allowed values: SCTE35

- files list of strings (Optional)
- label string (Optional)
- start object (Optional)

### Variants discriminated by `@odata.type`. Select one variant:

#### #Microsoft.Media.AbsoluteClipTime object [AbsoluteClipTime](https://docs.mediakind.com/api-reference/media-api/schemas/absolutecliptime)
- `@odata.type` string Required
- time string Optional

#### #Microsoft.Media.UtcClipTime object [UtcClipTime](https://docs.mediakind.com/api-reference/media-api/schemas/utccliptime)
- `@odata.type` string Required
- time string Optional

- trigger object [ScteTrigger](https://docs.mediakind.com/api-reference/media-api/schemas/sctetrigger) Optional
- filters list of list of maps (Optional)

outputs list of objects Required

### Variants discriminated by `@odata.type`. Select one variant:

#### #Microsoft.Media.JobOutputAsset object [JobOutputAsset](https://docs.mediakind.com/api-reference/media-api/schemas/joboutputasset)
- `@odata.type` string Required
- `assetName` string Required
- label string (Optional)
- priority enum Optional Defaults to Normal

## Response

201 Job was created

- id string Optional
  - Fully qualified resource ID for the resource.
- name string Optional
- properties object [JobProperties](https://docs.mediakind.com/api-reference/media-api/schemas/jobproperties) Required
  - Properties of the job

### Errors

400 Bad Request

- error object [ErrorDetail](https://docs.mediakind.com/api-reference/media-api/schemas/errordetail) Required
  - `code` string Required
  - `detail` string Required
  - `extraDetail` map from strings to any Optional

401 Unauthorized

403 Forbidden

404 Not Found

500 Internal Server Error