list_scheduled_runs

List all scheduled recurring model runs for a project. Use create_scheduled_run to add a new schedule, update_scheduled_run to change an existing one, or delete_scheduled_run to remove one. Cadence: 5-field UTC cron expression. Minimum interval: 15 minutes. Returns: schedules (list) — each schedule’s ID, cadence, enabled flag, next/last run times, and consecutive failure count; count (int) — number returned; message (str) — summary.

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
project_name	Annotated[str, Field(description='Name of the Bridge Town project.')]	Yes	—

Returns

Returns a structured object. Top-level fields:

• schedules (array<object>)
• count (integer)
• message (string)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "list_scheduled_runs",
  "arguments": {
    "project_name": "forecasts"
  }
}

Response

{
  "schedules": [
    {
      "schedule_id": "20202020-2020-2020-2020-202020202020",
      "project_name": "forecasts",
      "model_name": null,
      "branch": null,
      "cadence": "0 8 * * 1",
      "enabled": true,
      "next_run_at": "2026-05-12T08:00:00+00:00",
      "last_run_at": "2026-05-05T08:00:00+00:00",
      "last_run_id": "66666666-6666-6666-6666-666666666666",
      "last_run_status": "success",
      "consecutive_failure_count": 0,
      "created_at": "2026-04-28T10:00:00+00:00"
    }
  ],
  "count": 1,
  "message": "1 schedule(s) found."
}

Notes

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