Jobs

Long-poll a job to completion

Returns job status and output URLs. Pass ?wait=true to long-poll until the job completes or fails (up to ~60s). Returns 404 if the job does not exist or is not owned by the caller.

Select Masko-API-Version: 2026-09-26 (or api_version=2026-09-26) for the canonical mascot contract shown first. Existing unversioned clients keep legacy collection fields. A mascot_id query filter also selects the canonical contract. Mixing identifier names returns 400.

get/v1/jobs/{id}

Request

  • Base URL: https://api.masko.ai
  • URL: https://api.masko.ai/v1/jobs/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Query parameters

wait'true' | 'false'

If true, long-poll until the job completes, fails, or timeout is reached. If false or omitted, return the current status immediately.

timeoutnumber

Long-poll timeout in seconds when wait=true. 1 to 120. Defaults to 120. On timeout the response is 200 with the current (still pending) job state, not 408.

api_version'2026-09-26' | 'legacy'

Equivalent to the version header, for polling URLs and clients that accept only relative paths. Header and query must agree.

Headers

Masko-API-Version'2026-09-26' | 'legacy'

Use 2026-09-26 for mascot_id resource fields. Unversioned shared routes retain the legacy contract.

Response

Job details

OR

Changes

No recorded changes to this operation across all 1 revision of this API.