Get an action

GET

agents

{agentId}

actions

{kind}

{actionId}

curl -X GET "https://api.nedzo.ai/v1/agents/123e4567-e89b-12d3-a456-426614174000/actions/sms/1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed" \
    -H "Authorization: Bearer YOUR_API_KEY"

{
  "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": true,
  "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-11T10:00:00Z"
}

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

Path Parameters

string

required

Agent UUID

string

required

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

string

required

Action UUID

curl -X GET "https://api.nedzo.ai/v1/agents/123e4567-e89b-12d3-a456-426614174000/actions/sms/1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed" \
    -H "Authorization: Bearer YOUR_API_KEY"

{
  "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": true,
  "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-11T10:00:00Z"
}

The action comes back with its id, kind, agentId, its fields, createdAt and updatedAt. See Create an action for the fields of each kind.

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.

curl -X GET "https://api.nedzo.ai/v1/agents/123e4567-e89b-12d3-a456-426614174000/actions/sms/1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed" \
    -H "Authorization: Bearer YOUR_API_KEY"

{
  "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": true,
  "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-11T10:00:00Z"
}

API Reference

Workspaces

Agents

Phone Numbers

Contacts

Knowledge

Templates

Campaigns

Workflows

Conversations

Get an action

Path Parameters

Errors