Skip to main content
GET
Get video job status

Authorizations

Authorization
string
header
required

Motion API key (motion_ prefix), authenticated as its owner. Account and engine permissions still apply.

Path Parameters

job_id
string
required

Job ID returned by POST /sessions.

Response

Job status

job_id
string
required
status
enum<string>
required
Available options:
queued,
created,
running,
awaiting_user_input,
completed,
failed
created_at
string<date-time>
required
updated_at
string<date-time>
required
completed_at
string<date-time> | null
required
error
string | null
required
pending_user_input
boolean
required
output
object | null
required

Download readiness state. There is no separate public output/download endpoint; poll this status response until output.status is completed and output.download_url is non-null.

chat_url
string<uri> | null

Motion app chat URL for a human to open, inspect, or continue the run. Null for legacy jobs without a Motion agent chat.

sources
object[]

Additive source-asset audit list for media currently used in the composition. Empty when no source assets are recorded yet. Internal storage paths, filenames, and GCS URIs are not exposed.

engine
string | null

Null when engine details are unavailable to this account.

effort
enum<string> | null

Null when engine details are unavailable to this account.

Available options:
standard,
extended,
light,
medium,
high,
null
template
string | null