jobs

Get an async job's status and result

Read one async job — the uniform status/result resource behind every long-running operation. Poll until status is terminal (succeeded | failed | cancelled), then read result (kind-specific payload) or error (stable code + message). job_timeout means the executor died mid-run and the stall sweep reaped the job — re-enqueue the operation to retry.

get/v1/jobs/{jobId}

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/jobs/{jobId}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.cueframe.ai/api/auth/mcp/authorize, token URL https://api.cueframe.ai/api/auth/mcp/token, scopes: projects:read)
    • API key in header PAYMENT-SIGNATURE

Path parameters

jobIdstring required

Response

Job status/result.

idstring required

Job id — pass to GET /v1/jobs/{id} / wait_job.

jobKeystring required

Deterministic identity of the work (idempotency key, e.g. verify-<sessionId>-<contentHash> — the hash covers the composition AND grading inputs). Re-enqueueing the same key returns the same job while it runs.

kindstring required

Job family, e.g. verify.

status'running' | 'succeeded' | 'failed' | 'cancelled' required

Poll until terminal (succeeded | failed | cancelled).

createdAtstring required
updatedAtstring required
completedAtstring nullable required

Changes

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