Delete an agent automation
delete_agent_automation
Permanently deletes one agent automation on a site, along with its run history.
Deleting removes the automation and its run history, and it cannot be undone. Runs it started today still count toward the site's daily run limit until the UTC day ends. It is refused while a run of the automation is in progress, while its last charges are still settling, and when Modulify switched it off. Ask the person before you call it. See Agents.
Request
Call it with a POST to https://api.modulify.ai/v1/delete_agent_automation, 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_agent_automation \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"projectId":"PROJECT_ID","automationId":"AUTOMATION_ID"}'Over MCP, the same method is the delete_agent_automation tool.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
projectId |
string | Yes | The site id. |
automationId |
string | Yes | The automation id from list_agent_automations. |
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.