list_scheduled_runs

List all scheduled recurring model runs for a project. Returns each schedule’s ID, cadence, enabled flag, next and last run times, and consecutive failure count.

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
project_name	str	Yes	—	Target project name.

Returns

Returns a structured object. Top-level fields:

• schedules (array<object>) — list of schedule summaries
• count (integer) — number of schedules returned
• message (string)

Each schedule object has:

Field	Type	Description
schedule_id	string	UUID of the schedule
project_name	string	Project the schedule belongs to
model_name	string | null	Target model file stem, or null for project-level runs
branch	string | null	Target branch, or null for default
cadence	string	5-field UTC cron expression
enabled	boolean	Whether the schedule is active
next_run_at	string | null	ISO 8601 UTC timestamp of next scheduled run
last_run_at	string | null	ISO 8601 UTC timestamp of most recent run
last_run_id	string | null	Run ID of the most recent execution
last_run_status	string | null	Status of the most recent run
consecutive_failure_count	integer	Number of consecutive failed runs
created_at	string	ISO 8601 UTC creation timestamp

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": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "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.
• Use create_scheduled_run to add a new schedule.
• Use update_scheduled_run to pause, resume, or change cadence.
• Use delete_scheduled_run to remove a schedule.