Skip to content
Braiv Docs

Jobs and polling

When you start work that takes time, the API responds 202 with one or more job ids. Poll until ready or failed, or subscribe to webhooks.

Typical order after ingest:

  1. import_{videoId} becomes ready
  2. transcript_{videoId} becomes ready
  3. Product jobs (dub_*, shorts_*, packaging_*, …) leave queued and start

Quotes and reads of finished resources return 200. Language-video downloads are always jobs — see Create a download.

Terminal window
STATUS=$(curl -sS "$BRAIV_API_BASE/jobs/$JOB_ID" \
  -H "Authorization: Bearer $BRAIV_API_KEY" | jq -r .status)

A ready-made loop is in Poll until ready. Job id prefixes are listed under Job id format.