Documentation menu

Delete cron job

DELETEhttps://api.instacloud.com/projects/{projectId}/cron-jobs/{id}

Token scope: account · org · project — read-only tokens refused (not a GET).

Delete a cron job. It stops firing and cannot be restored; its run history is no longer readable. Gated — cron.delete.

Parameters

NameInTypeRequiredDescription
projectIdpathstringyes
idpathstringyes

Responses

200

Default Response

FieldTypeRequiredDescription
okbooleanno

202

Default Response

FieldTypeRequiredDescription
status"approval_required"no
approvalIdstringno
actionstringnothe gated action, or a comma-joined compound set — prefer `actions`
actionsstring[]noevery capability this approval covers
messagestringno
urlstringnothe console page where a project admin reviews this request
nextActionsobject[]no
nextActions.opstringyesNeutral logical action id, e.g. "service.add" — NOT an operationId or a CLI/MCP tool name; each client maps it to its own surface.
nextActions.reasonstringyesNatural-language, human/LLM-facing "why do this now".
nextActions.argsobjectnoSuggested, flat named arguments; "<placeholder>"s where a value is unknown.
nextActions.gatedbooleannoTrue if the action passes a governance gate.

403

Default Response

FieldTypeRequiredDescription
errorstringyes

404

Default Response

FieldTypeRequiredDescription
errorstringyes

View as Markdown