# Submit transform job

Submits one or more media transformation jobs for asynchronous processing.

Request:
jobs   - List of Job definitions to submit. Each Job includes:
contentSource   - The input media, specified as either a url or a contentId.
name             - Human-readable name for the job.
tasks            - Ordered list of Task operations to execute. Each Task specifies:
inputContentLabel  - Optional label to chain output from a prior task as input.
outputContentLabel - Optional label to reference this task's output in later tasks.
details              - Specifies the operation to perform. One of:
Delivery         - Defines where to store the transformed output (platform content storage or an external S3 location). Include one Delivery task as the final step of every job.
ImageTransform   - Resize, crop, change format (JPEG, PNG, WebP, AVIF), or convert the color space of an image.
VideoTranscoding - Transcode video to a different codec, bitrate, or resolution. Optionally generate a poster image, extract a transcription, or produce a keyframe montage.
DocumentTransform - Extract a poster image or text content from a document (PDF, Office formats).
notification     - Optional webhook URL to notify when the job completes.
correlationId   - Optional caller-supplied ID for correlating jobs with external systems.

Response:
jobs   - List of JobStatusResponse objects, one per submitted job, each containing
the assigned job id and initial status (QUEUED or PENDING).

Endpoint: POST /api/v1/transform/submit
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `jobs` (array)

## Response 200 fields (application/json):

  - `jobs` (array)

  - `jobs.id` (string)
    Rule data fields

  - `jobs.status` (integer)
    Enum: 0, 1, 2, 3, 4, 5, 6

  - `jobs.message` (string)
    Rule data fields

  - `jobs.correlationId` (string)
    Rule data fields

  - `jobs.results` (array)

  - `jobs.results.filename` (string)
    Rule data fields

  - `jobs.results.url` (string)
    Rule data fields

  - `jobs.results.mimeType` (string)
    Rule data fields

  - `jobs.results.size` (integer)

  - `jobs.results.properties` (any)

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)