Update an action

PATCH

agents

{agentId}

actions

{kind}

{actionId}

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 }'

{
  "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"
}

This endpoint is for the VIP plan only. Other plans get a 403. See Plan access.

Send only the fields to change. The fields for each kind are on Create an action. The API checks the same rules as the dashboard’s server.

Path Parameters

string

required

Agent UUID

string

required

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

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.

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 }'

{
  "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.

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 }'

{
  "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"
}

API Reference

Workspaces

Agents

Phone Numbers

Contacts

Knowledge

Templates

Campaigns

Workflows

Conversations

Update an action

Path Parameters

Rules on update

Errors