deleteSchedule

Delete a schedule

Delete a schedule. The skill itself is not changed. Ask the person to confirm first; to pause a schedule instead, use updateSchedule with enabled false.

Arguments

Argument	Type	Required	Description
`name`	string	required	The schedule name: lowercase letters, digits and hyphens, for example coaching-posts-mon-6pm.

Scopes

schedules:manage

Annotations

Read only: no
Destructive: yes

When to use

Call deleteSchedule when a person no longer wants a schedule. Ask them to confirm first: there is no undo. To stop it for a while, use updateSchedule with enabled: false instead.

The schedule tools need the schedules:manage scope. Only admin and staff can hold it. Schedules belong to the whole organisation: every admin and staff user sees and changes the same list, which also shows in the Sasha web interface, in Menu → Tasks.

name (required) picks the schedule. The skill and the results of earlier runs are not changed.

Example

{ "name": "client-digest-thu-6pm" }

The structured result (structuredContent):

{
  "deleted": "client-digest-thu-6pm"
}

Refusals and what to do

A schedule tool refuses with an error result. Its text is Error in deleteSchedule: <code>: <reason>.

schedule_not_found: no schedule has this name. Call listSchedules.
If the connection does not hold schedules:manage, the tool is not in your tool list, and a call to it returns MCP error -32602: Tool deleteSchedule not found. Only admin and staff can hold the scope, so a member's connection never has the schedule tools. A connection approved before the scope existed must reconnect, or the person mints a new token. Read the permissions section of getDocs.
Arguments that do not match the schema are refused before the tool runs, for example a name with capital letters or spaces, or an extra argument.
internal:unexpected (request <id>): something failed inside Sasha. Quote the request id in suggestImprovement.

listSchedules lists the schedules and their last result.
createSchedule adds a schedule.
updateSchedule changes, pauses or restarts a schedule.
deleteSchedule removes a schedule.
runSchedule runs a schedule once now.
getDocs has a schedules section with the same rules.