Delete a scheduled job
delete_site_cron
Permanently deletes one scheduled job from a site, along with its whole run history.
It stops firing immediately and there is no undo. Disabling it with toggle_site_cron is the reversible option and is usually what someone means by "turn this off". See Scheduled jobs.
Request
Call it with a POST to https://api.modulify.ai/v1/delete_site_cron, sending the inputs below as a JSON object. The token needs the config:write scope.
This method is marked destructive: it deletes or overwrites data. Check the inputs before you call it, and send an Idempotency-Key header whenever you might retry it.
curl -X POST https://api.modulify.ai/v1/delete_site_cron \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"projectId":"PROJECT_ID","cronId":"CRON_ID"}'Over MCP, the same method is the delete_site_cron tool.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
projectId |
string | Yes | The site id. |
cronId |
string | Yes | The job id from list_site_crons. |
Response
Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.