API reference/GET /jobs/{job_id}

Poll a video job

Check the status of an async video job. Poll this after POST /video/remove until status is done, then download the signed result URL. Jobs are visible only to the API key that created them.

GEThttps://useknockout--api.modal.run/jobs/{job_id}

Parameters

No parameters.

job_idrequiredstring–The job_id returned by POST /video/remove. Passed in the path: /jobs/{job_id}.

Request

curl "https://useknockout--api.modal.run/jobs/JOB_ID" \
  -H "Authorization: Bearer $TOKEN"

Response

HTTP/1.1 200 OK
content-type: application/json

Errors

401unauthorized–Missing or invalid token.
404not_found–No job with that id for this API key.
Every error response also includes a request_id in the JSON body. Quote it when reporting issues.

Notes

  • status is one of queued, processing, done, or error. progress is 0-100.
  • result_url appears only when status is done. It's a signed URL valid for 1 hour: download or rehost before it expires.
  • The done response includes output_seconds, the exact number of output seconds billed for the job.
  • Jobs are scoped to the API key that created them. A different key gets 404.
  • Poll every 1-2 seconds. Processing time scales with clip length and resolution.
← POST /video/removePOST /preview →