job_get

Management

Get Job

Get one Scenario job — compact status row (status, progress, result asset ids). Args: - job_id: required - verbose: optional — true returns the full raw job record (statusHistory, full metadata.input incl. the original prompt, workflow flow). Default false. - team_id, project_id: required for OAuth callers Returns: { job } compact row — jobId, jobType, status, progress, modelId, assetIds, cuCost, workflowId (when set), error/hint (when set), createdAt, updatedAt. Pass verbose=true only when you need the full record (failure forensics, workflow flow state). Example: "How is this job doing?" -> job_id="job_xxx" Don't use when: you want to block until jobs finish — use jobs_wait; or start work — use model_run, asset_analyze, train, or workflow_run.
read-onlyidempotentopen-world

Parameters

NameTypeRequiredDescription
job_idstringJob ID to fetch.
verbosebooleanfalsetrue returns the full raw job record (statusHistory, full metadata.input incl. the original prompt, workflow flow). Default false returns the compact row — prefer it in polling loops.
team_idstringTeam ID. Required if user belongs to multiple teams.
project_idstringProject ID to scope the operation to.
response_formatenum(json | markdown)jsonOutput 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",
    "jobType": "custom",
    "status": "success",
    "progress": 1,
    "assetIds": [
      "asset_img001"
    ],
    "cuCost": 48
  }
}

Common Use Cases

  • Check the current status of a generation job by job ID
  • Retrieve output asset IDs once a job completes