Skip to main content

​
Update Agent

Update an existing agent. Users can only update their own agents.
​
path
string
required
Agent ID (numeric or ElevenLabs agent ID)

​
Request Body

​
object
required
Agent object with fields to update
​
string
Agent name
​
array
Array of tag strings
​
object
Agent conversation configuration
​
object
Platform-specific settings
​
object
Widget configuration for web integration
curl -X PUT "https://api.example.com/api/v1/agents/123" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {
      "name": "Updated Agent Name",
      "tags": ["support", "voice", "updated"],
      "conversation_config": {
        "temperature": 0.8
      }
    }
  }'

​
Response

​
status
object
Response status information
​
code
integer
HTTP status code (200)
​
message
string
Status message
​
data
object
Updated agent object (see Agent schema)
{
  "status": {
    "code": 200,
    "message": "Agent updated successfully"
  },
  "data": {
    "id": "123",
    "name": "Updated Agent Name",
    "tags": ["support", "voice", "updated"],
    "conversation_config": {
      "temperature": 0.8
    },
    "platform_settings": {},
    "published": true,
    "published_at": "2024-01-15T10:30:00Z",
    "elevenlabs_agent_id": "agent_abc123",
    "version": 2,
    "phone_numbers": [],
    "user_id": 1,
    "user_email": "[email protected]",
    "created_at": "2024-01-10T08:00:00Z",
    "updated_at": "2024-01-15T11:00:00Z"
  }
}

​
Error Responses

​
401
object
Unauthorized - Invalid or missing authentication
​
404
object
Agent not found
​
422
object
Validation error - Invalid request body