---
title: "Submit a new job"
slug: "submit-a-new-job-1"
updated: 2025-11-21T01:09:48Z
published: 2025-11-21T01:09:59Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wasabi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit a new job

Post/jobs

Submit a job with specified configuration and settings.

SecurityAPI Key: WasabiAuthHeader parameter namex-amz-access-key

Wasabi access key for authenticating requests. A valid Wasabi User access key is required for API calls.

API Key: WasabiSecretAuthHeader parameter namex-amz-secret-key

Wasabi secret key for authenticating requests. A valid Wasabi User secret key is required along with the access key.

Body parameters

Job details for processing

<select class='api-response-data' aria-label='Media type'><option value='987f2b81-4f8f-4772-a7d1-acb4a7ffc226'>application/json</option>
</select>Expand Allobject  Namestring    Required

Name of the job

Min length1Max length256Pattern^.*\S.*$ExampleMyJobName
Priorityinteger    

Job priority (1-10)

Minimum1Maximum10Example5
Servicesobject  Required

Required. Select which services to execute and optionally provide per‑service configuration. Fewer than 1 service will be rejected.

- Provide a JSON object where each key is a service identifier (e.g., "ocr", "s2t", "nld", "audiotag", "face", "logo").
- Include a key to enable that service.
- For each service value:
  - use  to accept defaults, or
  - provide an object with "config" to override service‑specific parameters (e.g., confidence thresholds).

Example{
  "ocr": "",
  "s2t": "",
  "nld": "",
  "audiotag": "",
  "face": "",
  "logo": {
    "config": {
      "rec_confidence_threshold": 0.85
    }
  }
}

Batchstring    

Optional batch identifier for grouping jobs

Max length256Examplebatch_2024_11_21
Destinationobject  RequiredBucketstring    Required

Destination bucket name

Exampleairstream-output-2
Regionstring    Required

S3 region

Exampleus-west-1

Sourceobject  RequiredEndpointstring    

S3 endpoint URL

Examples3.us-west-1.wasabisys.com
Bucketstring    Required

Source bucket name

Examplewasabifs-chm
Regionstring    

S3 region

Exampleus-west-1
ObjectKeystring    Required

Object key or path to the file

ExampleMP4/Commercial.mp4

Responses200

Job submission successful

<select class='api-response-data' aria-label='Media type'><option value='1699ac53-3a03-482f-8b63-acdef2623cb6'>application/json</option>
</select>Expand Allobject  Jobobject (Job)  Idstring    

Unique ID for the job

Example67345137bcb6dce44b35a6a6281711e7
Namestring    

Name of the job

ExampleMyJobName
Sourceobject  Endpointstring    

S3 endpoint URL

Examples3.us-west-1.wasabisys.com
Bucketstring    

Source bucket name

Examplewasabifs-chm
Regionstring    

S3 region

Exampleus-west-1
ObjectKeystring    

Object key or path to the file

ExampleMP4/Commercial.mp4
Providerstring    

Storage provider, e.g., wasabi, OBS, IBM

Servicesobject  

Services and their configurations

Example{
  "ocr": "",
  "s2t": "",
  "nld": "",
  "audiotag": "",
  "face": "",
  "logo": {
    "config": {
      "rec_confidence_threshold": 0.85
    }
  }
}

UserIdstring    

User who submitted the job (e.g., an ARN)

Example10000
Createdstring  (date-time)    

Timestamp when the job was created

Example2024-11-13T07:11:51.658Z
Completedstring  (date-time)    

Timestamp when the job was completed

Example2024-11-13T07:11:51.658Z
Priorityinteger    

Job priority (1-10). example: 5

Batchstring    

Optional batch identifier for grouping jobs

Examplebatch_2024_11_21
Statusstring    

Current status of the job

Valid values[
  "submitted",
  "preflight",
  "in_progress",
  "completed",
  "failed",
  "cancelled"
]Examplesubmitted
Destinationobject  Bucketstring    

Destination bucket name

Exampleairstream-output-2
Regionstring    

S3 region

Exampleus-west-1

400

Invalid request (e.g., parsing errors, missing/invalid fields, source/destination issues)

<select class='api-response-data' aria-label='Media type'><option value='afa63b96-8c82-458f-b7bb-88696b7e0241'>application/json</option>
</select>

```json
{
  "Error": "source object not found or inaccessible",
  "ErrorCode": "BAD_REQUEST"
}
```

object  Errorstring    

Error message explaining what went wrong

ExampleAn unexpected error occurred while processing the job.
ErrorCodestring    

Error code for troubleshooting

ExampleINTERNAL_ERROR

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='b2c4ad80-746b-459e-b549-0bd5d1cc6b81'>application/json</option>
</select>

```json
{
  "Error": "Unauthorized",
  "ErrorCode": "UNAUTHORIZED"
}
```

object  Errorstring    

Error message explaining what went wrong

ExampleAn unexpected error occurred while processing the job.
ErrorCodestring    

Error code for troubleshooting

ExampleINTERNAL_ERROR

403

Monthly quota reached

<select class='api-response-data' aria-label='Media type'><option value='d0800d6a-2f7e-4f39-8151-7e46e1a8d47e'>application/json</option>
</select>object  Errorstring    

Error message explaining what went wrong

ExampleAn unexpected error occurred while processing the job.
ErrorCodestring    

Error code for troubleshooting

ExampleINTERNAL_ERROR

429

Daily Cap Exceeded

<select class='api-response-data' aria-label='Media type'><option value='b4849e05-884d-4cf6-be66-65a6440d939b'>application/json</option>
</select>object  Errorstring    

Error message explaining what went wrong

ExampleAn unexpected error occurred while processing the job.
ErrorCodestring    

Error code for troubleshooting

ExampleINTERNAL_ERROR

500

Internal Server Error

<select class='api-response-data' aria-label='Media type'><option value='730b7600-a1a0-4b0e-81ad-4251ab2fe64a'>application/json</option>
</select>

```json
{
  "Error": "An unexpected error occurred while processing the job.",
  "ErrorCode": "INTERNAL_ERROR"
}
```

object  Errorstring    

Error message explaining what went wrong

ExampleAn unexpected error occurred while processing the job.
ErrorCodestring    

Error code for troubleshooting

ExampleINTERNAL_ERROR