Delete an agent automation

delete_agent_automation

Permanently deletes one agent automation on a site, along with its run history.

POST /v1/delete_agent_automationScopeconfig:writeDestructive

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.