Jobs
The asynchronous job routes are not built yet: the gateway mounts none of them, so each answers 404 route_not_found. Until they are, every task type that is served runs synchronously, on POST /v1/tasks (Tasks) or on POST /v1/embeddings and POST /v1/rerank (Embeddings and rerank), and many requests at once will run as a batch once batches are offered. The contract below is what the routes will answer when they are built.
| Route | Today |
|---|---|
POST /v1/jobs | Not built: 404 route_not_found |
GET /v1/jobs/{id} | Not built: 404 route_not_found |
GET /v1/jobs | Not built: 404 route_not_found |
POST /v1/jobs/{id}/cancel | Not built: 404 route_not_found |
- Route
POST /v1/jobs- Today
- Not built: 404
route_not_found
- Route
GET /v1/jobs/{id}- Today
- Not built: 404
route_not_found
- Route
GET /v1/jobs- Today
- Not built: 404
route_not_found
- Route
POST /v1/jobs/{id}/cancel- Today
- Not built: 404
route_not_found
Note
Not built. A task type that runs only as a job (video_generation) answers 400 use_jobs on POST /v1/tasks, and no model of that type is priced yet.
Job object
{ "object": "job", "id": "job_...", "status": "queued", "model": "<pinned id>", "task": "video_generation", "created_at": "2026-10-20T12:00:00Z", "transitions": [{"status": "queued", "at": "2026-10-20T12:00:00Z"}], "requirements": {"pool": "certified", "pricing_mode": "market", "region": null, "fallback": false}, "quote": "quote_...", "result": null, "error": null, "usage": null, "expires_at": null}| Status | Meaning | Terminal |
|---|---|---|
queued | Accepted, quote bound, no worker yet | No |
assigned | A worker took it; the attempt is att_ | No |
running | The worker reported a start | No |
completed | result is set; usage and the cost are final | Yes |
failed | error is set (the envelope's shape); nothing billed unless the retries page says otherwise | Yes |
canceled | By POST /v1/jobs/{id}/cancel, by a client disconnect or by the workspace being paused; the running attempt, if any, ends interrupted with reason canceled | Yes |
interrupted | An attempt was interrupted after a streamed partial answer had already reached the client, or the attempt limit was reached after an interruption; nothing billed | Yes |
- Status
queued- Meaning
- Accepted, quote bound, no worker yet
- Terminal
- No
- Status
assigned- Meaning
- A worker took it; the attempt is
att_ - Terminal
- No
- Status
running- Meaning
- The worker reported a start
- Terminal
- No
- Status
completed- Meaning
resultis set;usageand the cost are final- Terminal
- Yes
- Status
failed- Meaning
erroris set (the envelope's shape); nothing billed unless the retries page says otherwise- Terminal
- Yes
- Status
canceled- Meaning
- By
POST /v1/jobs/{id}/cancel, by a client disconnect or by the workspace being paused; the running attempt, if any, endsinterruptedwith reasoncanceled - Terminal
- Yes
- Status
interrupted- Meaning
- An attempt was interrupted after a streamed partial answer had already reached the client, or the attempt limit was reached after an interruption; nothing billed
- Terminal
- Yes
Parts list: Routes
POST /v1/jobsThe same body as a task, answered 202 at once with the job object.
GET /v1/jobs/{id}The job object.
resultholds inline results or, for media,outputswith a presigned GET.GET /v1/jobsThe workspace's jobs, newest first, cursor-paginated.
POST /v1/jobs/{id}/cancelqueued: canceled at once, nothing billed.assignedorrunning: the attempt endsinterruptedand the jobcanceled; the charge for work done is Not decided yet.
| Status | Type | Code | Situation | Retry |
|---|---|---|---|---|
| 400 | invalid_request_error | use_jobs | A task type that runs only as an asynchronous job (video_generation); the job routes are not built yet | No |
| 404 | not_found_error | route_not_found | Unknown path, among them every /v1/jobs path (not built) and Knowledge's paths while Knowledge is switched off | No |
- Status
- 400
- Type
invalid_request_error- Code
use_jobs- Situation
- A task type that runs only as an asynchronous job (
video_generation); the job routes are not built yet - Retry
- No
- Status
- 404
- Type
not_found_error- Code
route_not_found- Situation
- Unknown path, among them every
/v1/jobspath (not built) and Knowledge's paths while Knowledge is switched off - Retry
- No
Related sheets
- Sheet
- 18 of 20
- Detail
- K
- Updated
- 2026-11-11