list_runs

List recent runs for a project, ordered most-recent-first. Use this for run history discovery — e.g. ‘show the last 5 runs’, ‘find the latest run’, ‘check recent statuses’. Returns up to limit run summaries (1–50, default 10). Optionally filter by status: pending, running, success, failed, timed_out, or cancelled. To inspect a specific run’s full output, pass its run_id to get_run. Returns: project_name (str); runs (list) — each entry has run_id, run_number, status, commit_sha, started_at, finished_at, created_at; total_returned (int) — count of runs in this response.

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
project_name	str	Yes	—
limit	int	No	10
status	str	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.