delete_scheduled_run

Delete a scheduled model run. DESTRUCTIVE — defaults to dry_run=True: previews what would be deleted and returns a confirmation_token valid for 5 minutes. To execute: call again with dry_run=False and echo the confirmation_token. schedule_id is required (from list_scheduled_runs).

destructive

Parameters

Name	Type	Required	Default	Description
schedule_id	Annotated[str, Field(description='UUID of the scheduled run to manage.')]	Yes	—
dry_run	Annotated[bool, Field(description='When true, validate and preview the deletion without removing the schedule.')]	No	True
confirmation_token	`Annotated[str	None, Field(description=‘Token required to confirm deletion (returned by a dry run).’)]`	No	None

Returns

Returns a structured object. Top-level fields:

• dry_run (boolean)
• schedule_to_delete (object)
• schedule_deleted (null)
• confirmation_token (string)
• message (string)
• audit (null)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "delete_scheduled_run",
  "arguments": {
    "schedule_id": "20202020-2020-2020-2020-202020202020",
    "dry_run": true
  }
}

Response

{
  "dry_run": true,
  "schedule_to_delete": {
    "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"
  },
  "schedule_deleted": null,
  "confirmation_token": "tok_del_20202020_2026-05-10T12:00:00Z",
  "message": "Dry run: would delete schedule 20202020-2020-2020-2020-202020202020. Pass dry_run=False with confirmation_token to proceed.",
  "audit": null
}

Notes

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