Skip to main content
GET
Poll a job

Authorizations

Authorization
string
header
required

Authorization: Bearer mm_live_…. Mint a key at mediamonster.app/keys; every plan includes the API. A test key, mm_test_…, runs every check a live key does and spends nothing: each run finishes at once with a stand-in file, and says livemode: false. A key does only what its scopes allow.

Headers

X-Request-Id
string

Your own id for this request — 8 to 128 letters, digits, ., _, : or -. Used in place of one we mint, and echoed back.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$

Path Parameters

id
string<uuid>
required

The job's id.

Query Parameters

stream
boolean
default:false

true to answer text/event-stream: an event: status each time it changes, then event: done with it settled — or as it stands after 150 seconds, when the stream closes. A keepalive comment every 15 seconds holds it open.

Response

The job — or, with stream=true, its changes as they happen.

One run of one skill, or one conversion. While status is queued or processing, poll poll_url.

id
string<uuid>
required
status
enum<string>
required
Available options:
queued,
processing,
complete,
failed
outputs
object[]
required
poll_url
string
required
Example:

"/api/v1/jobs/3f0c…"

skill
string | null

The skill's slug; null for a conversion.

format
string | null

What a conversion wrote; null for a skill.

source
object
error
string | null
created_at
string<date-time>
updated_at
string<date-time>
livemode
boolean

False for a test key's (mm_test_…) run, which charged nothing and ran nothing.

test
any

Present, and true, only on a test key's run.