get_run

Use get_run to poll or inspect one run by run_id

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
run_id	Annotated[str, Field(description='UUID of the run to look up, or a UUID prefix (hex digits and dashes only). Use list_runs to discover run IDs for a project.')]	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.