delete_scheduled_run

Delete a scheduled model run. This is a destructive operation. The tool defaults to dry_run=true to prevent accidental deletion.

Confirmation workflow

1. Call with dry_run=true (default) — returns schedule_to_delete and a confirmation_token valid for 5 minutes.
2. Call again with dry_run=false and the confirmation_token — executes the deletion and returns an audit record.

Parameters

Name	Type	Required	Default	Description
schedule_id	str	Yes	—	UUID of the schedule to delete (from list_scheduled_runs).
dry_run	bool	No	true	Preview what would be deleted without executing.
confirmation_token	str | None	No	None	Token from the dry-run response. Required when dry_run=false. Expires after 5 minutes.

Returns

Returns a structured object. Top-level fields:

• dry_run (boolean) — whether this was a preview
• schedule_to_delete (object \| null) — schedule that would be deleted (dry-run only)
• schedule_deleted (object \| null) — schedule that was deleted (execute only)
• confirmation_token (string \| null) — token for confirming deletion (dry-run only)
• message (string)
• audit (object \| null) — deletion audit record (execute only): deleted_schedule_id, project_name, cadence, deleted_by, deleted_at

Example

Step 1 — dry run

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

Response:

{
  "dry_run": true,
  "schedule_to_delete": {
    "schedule_id": "20202020-2020-2020-2020-202020202020",
    "project_name": "forecasts",
    "cadence": "0 8 * * 1",
    "enabled": true,
    "next_run_at": "2026-05-12T08:00:00+00:00",
    "..."
  },
  "schedule_deleted": null,
  "confirmation_token": "dXVpZHwxNzE1Mjk...",
  "message": "Dry run: schedule '20202020-...' would be deleted. Pass dry_run=false with the confirmation_token to execute.",
  "audit": null
}

Step 2 — execute

{
  "name": "delete_scheduled_run",
  "arguments": {
    "schedule_id": "20202020-2020-2020-2020-202020202020",
    "dry_run": false,
    "confirmation_token": "dXVpZHwxNzE1Mjk..."
  }
}

Response:

{
  "dry_run": false,
  "schedule_to_delete": null,
  "schedule_deleted": {
    "schedule_id": "20202020-2020-2020-2020-202020202020",
    "project_name": "forecasts",
    "cadence": "0 8 * * 1",
    "..."
  },
  "confirmation_token": null,
  "message": "Schedule '20202020-...' deleted.",
  "audit": {
    "deleted_schedule_id": "20202020-2020-2020-2020-202020202020",
    "project_name": "forecasts",
    "cadence": "0 8 * * 1",
    "deleted_by": "user-uuid",
    "deleted_at": "2026-05-09T10:05:00+00:00"
  }
}

Notes

• Module: Scheduled Runs
• Requires authentication via API token or Auth0 JWT.
• The confirmation token is scoped to the requesting tenant and expires after 5 minutes.
• Deleting a schedule does not cancel in-progress runs triggered by it. Use cancel_run for that.