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

# Update an action

> Change one of an agent's built-in actions. Send only the fields to change.

> [!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).

Send only the fields to change. The fields for each kind are on [Create an action](https://docs.nedzo.ai/api-reference/agents/actions/create.md). The API checks the same rules as the dashboard's server.

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

## Rules on update

* Transfer: you may leave out `transferSentence`, but you can't set it to empty. A `transferNumber` you send must be in E.164 format.
* WhatsApp: when you set `messageMode` to `fixed`, send `messageTemplate` in the same request.
* SMS and WhatsApp: when you set `recipientType` to `specific`, send `recipientValue` in the same request.

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

```json Response theme={null}
{
  "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
  "kind": "sms",
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Send booking link",
  "condition": "The caller wants to book",
  "isActive": false,
  "phoneNumberId": "8f14e45f-ceea-467a-9575-0d3c8f9e1a9b",
  "recipientType": "contact",
  "recipientValue": null,
  "messageTemplate": "Book here: https://example.com/book",
  "messageMode": "fixed",
  "parameters": [],
  "createdAt": "2026-10-11T10:00:00Z",
  "updatedAt": "2026-10-11T11:00:00Z"
}
```

## Errors

| Status | When |
| - | - |
| `400` | A field is wrong, `phoneNumberId` is not a number in the agent's workspace, or a transfer is on a chat or widget agent. |
| `404` | The agent or the action is not in your API key's scope, the action belongs to another agent, `whatsappSenderId` is not a WhatsApp number in the agent's workspace, or `{kind}` is not one of the six. |


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