Delete a schedule
Stops a schedule for good, or cancels a one-off run before it runs; past runs stay in the call log.
Free
This tool costs nothing to call.
An example
Stop the weekly journal export. The accountant reads the books directly now.
Your agent callsschedules_deleteFree
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"schedule_id": 4112
}Use it when
A schedule is no longer needed, or a later run should not happen.
What it does
Stop a schedule for good and end its monthly rent. Its past runs stay in the call log.
What comes back
deleted: the schedule_id. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
schedule_idRequired | integer | The schedule_id schedules_create returned. At least 1. |
The call
Over MCP, call schedules_delete on https://api.conecto.chat/mcp/schedules. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/schedules_delete \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"schedule_id":4112}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No schedule of the business has that schedule_id. | Find it with schedules_list. |
More Schedules tools
All 6 tools- Repeat a tool call
schedules_createRuns a tool call on a timetable in the business's time zone, from every 15 minutes to once a month; each run is a normal call at the tool's price.$0.50 a call - Run a tool call once, later
schedules_run_laterRuns one tool call once at a set time, up to a year ahead, with no monthly rent.$0.01 a call - List schedules
schedules_listEvery schedule and waiting one-off run: what it runs and when, as which bot, and how its last run went.Free* - Get a schedule
schedules_getOne schedule in full: its next three runs, its last ten runs with their call_ids and costs, and its rent.Free* - Change a schedule
schedules_updateChanges a schedule's name, arguments, timetable or time zone, or pauses and resumes it.$0.001 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md