job_check
ManagementCheck Job
Check one Scenario job — full status, progress, and result asset ids.
Args:
- job_id: required
- team_id, project_id: required for OAuth callers
Returns: the full job record (statusHistory, metadata, asset ids).
Example: "Check this job" -> job_id="job_xxx"
Don't use when: you want to start work — use model_run, analyze, train, or workflow_run.
read-onlyidempotentopen-world
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| job_id | string | ✓ | Job ID to check. |
| team_id | string | — | Team ID. Required if user belongs to multiple teams. |
| project_id | string | — | Project ID to scope the operation to. |
| response_format | enum(json | markdown) | json | Output format: 'json' for structured data, 'markdown' for human-readable text. |
Example Request
JSON
{
"job_id": "job_gen_123",
"team_id": "team_abc123",
"project_id": "proj_xyz789"
}Example Response
JSON
{
"job": {
"jobId": "job_gen_123",
"status": "success",
"type": "generate",
"metadata": {
"assetIds": [
"asset_img001"
]
}
}
}Common Use Cases
- Check the status of a long-running generation job by job ID
- Retrieve output asset IDs once a job completes