job_check

Management

Check 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

NameTypeRequiredDescription
job_idstringJob ID to check.
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",
    "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