Skip to main content
PATCH
https://api.nedzo.ai/v1
/
agents
/
{id}
curl -X PATCH "https://api.nedzo.ai/v1/agents/123e4567-e89b-12d3-a456-426614174000" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Updated Agent Name",
      "prompt": "Updated system prompt...",
      "isActive": true,
      "backgroundSound": true,
      "openingLine": "Hello! How can I help you today?",
      "language": "spanish",
      "voicemail": false,
      "voicemailMessage": "Please leave a message after the tone.",
      "callDuration": 30,
      "voiceId": "voice_123"
    }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Updated Agent Name",
  "agentType": "Inbound Voice",
  "prompt": "Updated system prompt...",
  "isActive": true,
  "backgroundSound": true,
  "openingLine": "Hello! How can I help you today?",
  "language": "spanish",
  "voicemail": false,
  "voicemailMessage": null,
  "hipaaCompliance": false,
  "callDuration": 30,
  "speed": 1.0,
  "voiceId": "voice_123",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T11:00:00Z"
}
Update an agent’s details. All fields are optional - only provided fields will be updated.

​
Path Parameters

​
id
string
required
The unique UUID of the Agent

​
Common Fields

​
name
string
Agent name (1-255 characters)
​
isActive
boolean
Whether the agent is active
​
prompt
string
System prompt for the agent
​
language
string
Agent language. Valid values: english, spanish, french, german, portuguese, dutch, chinese, japanese

​
Type-Specific Fields

​
openingLine
string
Opening line the agent says when starting a conversation
​
voiceId
string
Voice ID for text-to-speech
​
backgroundSound
boolean
Enable background sound
​
hipaaCompliance
boolean
When this is enabled, no logs, recordings, or transcriptions will be stored
​
callDuration
integer
Maximum call duration in minutes, 1-60
​
speed
number
Voice speed multiplier, 0.5-1.5
curl -X PATCH "https://api.nedzo.ai/v1/agents/123e4567-e89b-12d3-a456-426614174000" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Updated Agent Name",
      "prompt": "Updated system prompt...",
      "isActive": true,
      "backgroundSound": true,
      "openingLine": "Hello! How can I help you today?",
      "language": "spanish",
      "voicemail": false,
      "voicemailMessage": "Please leave a message after the tone.",
      "callDuration": 30,
      "voiceId": "voice_123"
    }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Updated Agent Name",
  "agentType": "Inbound Voice",
  "prompt": "Updated system prompt...",
  "isActive": true,
  "backgroundSound": true,
  "openingLine": "Hello! How can I help you today?",
  "language": "spanish",
  "voicemail": false,
  "voicemailMessage": null,
  "hipaaCompliance": false,
  "callDuration": 30,
  "speed": 1.0,
  "voiceId": "voice_123",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T11:00:00Z"
}