# delete_agent_automation

Source: https://modulify.ai/docs/api/agent-automations/delete-agent-automation

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

- Title: Delete an agent automation
- Scope: `config:write`
- Access: Destructive
- Endpoint: `POST /v1/delete_agent_automation`

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](https://modulify.ai/docs/automations/agents#delete-an-agent).

## 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.

> **Warning**
>
> This method is marked destructive: it deletes or overwrites data. Check the inputs before you call it, and send an [Idempotency-Key](https://modulify.ai/docs/api/idempotency) header whenever you might retry it.

```bash
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](https://modulify.ai/docs/mcp/agent-automations/delete-agent-automation).

## 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](https://modulify.ai/docs/api/requests-and-responses#the-response) 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](https://modulify.ai/docs/api/requests-and-responses#headers-on-every-method-call) 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](https://modulify.ai/docs/api/errors) explains every status code a call can answer with.