> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete an action

> Delete one of an agent's built-in actions.

> [!NOTE]
>
> This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](https://docs.nedzo.ai/api-reference/introduction.md#plan-access).

The agent stops using the action. Returns `204`.

## Path Parameters

**agentId** `string` *required*

Agent UUID

**kind** `string` *required*

The kind of action: `calendar`, `transfer`, `sms`, `email`, `whatsapp` or `slack`.

**actionId** `string` *required*

Action UUID

```bash cURL theme={null}
curl -X DELETE "https://api.nedzo.ai/v1/agents/123e4567-e89b-12d3-a456-426614174000/actions/sms/1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed" \
    -H "Authorization: Bearer YOUR_API_KEY"
```

```json Response theme={null}
// 204 No Content
```

## Errors

| Status | When |
| - | - |
| `400` | An id is not a valid UUID. |
| `404` | The agent or the action is not in your API key's scope, the action belongs to another agent, or `{kind}` is not one of the six. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.