list_runs

Use list_runs to find recent execution history before selecting a run_id

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
project_name	Annotated[str, Field(description='Name of the project whose run history to list.')]	Yes	—
limit	Annotated[int, Field(description='Maximum number of runs to return. Clamped to 1–50; defaults to 10.')]	No	10
status	Annotated[Literal['', 'pending', 'running', 'success', 'failed', 'timed_out', 'cancelled'], Field(description='Optional status filter. One of: pending, running, success, failed, timed_out, cancelled. Omit or pass empty string for no filter.')]	No	''

Returns

Returns a structured object. Top-level fields:

• project_name (string)
• runs (array<object>)
• total_returned (integer)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "list_runs",
  "arguments": {
    "project_name": "forecasts",
    "limit": 10
  }
}

Response

{
  "project_name": "forecasts",
  "runs": [
    {
      "run_id": "66666666-6666-6666-6666-666666666666",
      "run_number": null,
      "status": "success",
      "commit_sha": "abc1234def5678901234567890abcdef12345678",
      "started_at": "2026-04-28T10:00:00+00:00",
      "finished_at": "2026-04-28T10:00:01.420000+00:00",
      "created_at": "2026-04-28T10:00:00+00:00"
    }
  ],
  "total_returned": 1
}

Notes

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