CubePathDOCS

Transcoder

List transcoding jobs

get/transcoder/jobs

View all your transcoding jobs and their progress. Filter by batch to follow a bulk submission.

Authorization

Authorization
Authorization*string

Bearer YOUR_API_TOKEN with an API token. The X-API-Key: YOUR_API_TOKEN header works too.

Query parameters

batch_id?string | null
Rangelength ≤ 36
limit?integer
Range1 ≤ value ≤ 500Default100
offset?integer
Range0 ≤ valueDefault0

Responses

Successful Response

application/json

jobs*array<TranscodeJobOut>
Properties (12)
uuid*string
status?string | null

queued, analyzing, encoding, finalizing, completed, failed, canceled

input?record<string, any> | null

Source of the video {source, url, s3}. s3.secret_key is never returned

output?record<string, any> | null

Destination storage {s3}. s3.secret_key is never returned

spec?record<string, any> | null

Requested outputs: {outputs: [OutputSpec, ...]}

outputs?any

Files produced by the job ([{type, bucket, key}]); null until the job finishes

progress?integer | null

Progress percentage (0-100)

total_segments?integer | null
completed_segments?integer | null
batch_id?string | null

Set when the job was created through a bulk submission

error?string | null
created_at?string | null
limit*integer
offset*integer