Read a job
jobA job's status and, once it is ok, its files as signed URLs (and small PNGs inline). For a queued job (video_still, video_render, raster_render, and a large pull_analyse, pull_twin or pull_lab) the status is queued, running, ok, refused, failed, cancelled or expired; wait_s (at most 25) holds the answer until the job ends. A queued pull job's result is its verdict, and its whole report is the file report.json. Costs nothing.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"job": "<job>"
},
"name": "job"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | Yes | The job id from the call that queued it, such as job_ followed by 24 hex digits. | |
| wait_s | No | Seconds to hold the answer until the job ends; 0 answers at once. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | Yes | The job id. | |
| verb | No | The tool that made it. | |
| files | No | Files made, each with a name, type, size and a signed URL. | |
| units | No | Units charged. | |
| status | Yes | queued, running, ok, refused, failed, cancelled or expired. |