get_run

Retrieve a model run by run_id and return its current status and output. Use after run(mode=‘async’) to poll status: pass the run_id and read the status field — terminal states are success, failed, timed_out, and cancelled. Also use to inspect any past run by its concrete run_id or UUID prefix. To discover recent runs or find the latest run, use list_runs instead. Do NOT call this immediately after a successful run(mode=‘sync’) response: sync runs already return all terminal results inline (stdout, stderr, exit_code, outputs, run_id) and the run is already complete. On success the ‘output’ field contains the full run payload (stdout, stderr, exit_code, outputs dict) up to 1 MiB; truncated=true if cut. Returns: run_id (str) — run UUID; run_number (int|null) — sequential run counter; project_name (str) — project name; status (str) — pending/running/success/failed/timed_out/cancelled; commit_sha (str|null) — git commit that was executed; started_at (str|null) — ISO 8601 start timestamp; finished_at (str|null) — ISO 8601 finish timestamp; error_message (str|null) — failure description when status is not success; output (any|null) — full run payload (stdout, stderr, exit_code, outputs) when status=success, up to 1 MiB; truncated (bool) — true when output exceeded 1 MiB and was cut.

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
run_id	str	Yes	—

Returns

Returns a structured object. Top-level fields:

• run_id (string)
• run_number (null)
• project_name (string)
• status (string)
• commit_sha (string)
• started_at (string)
• finished_at (string)
• error_message (null)
• output (object)
• truncated (boolean)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "get_run",
  "arguments": {
    "run_id": "66666666-6666-6666-6666-666666666666"
  }
}

Response

{
  "run_id": "66666666-6666-6666-6666-666666666666",
  "run_number": null,
  "project_name": "forecasts",
  "status": "success",
  "commit_sha": "abc1234def5678901234567890abcdef12345678",
  "started_at": "2026-04-28T10:00:00+00:00",
  "finished_at": "2026-04-28T10:00:01.420000+00:00",
  "error_message": null,
  "output": {
    "status": "success",
    "exit_code": 0,
    "stdout": "Run completed in 1.42s\n",
    "stderr": "",
    "outputs": {
      "revenue": [
        100,
        110,
        121
      ]
    }
  },
  "truncated": false
}

Notes

• Module: Execution
• Requires authentication via API token or Auth0 JWT.