Skip to main content
PUT
/
v1
/
agents
/
{id}
curl --location --request PUT 'https://api.stateset.com/v1/agents/agent_123' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <api_key>' \
--data-raw '{
    "agent_name": "Support Bot v2",
    "description": "Updated return and warranty support agent",
    "instructions": "Ask clarifying questions before taking action.",
    "activated": true
}'

{
  "agent_name": "<string>",
  "agent_type": "<string>",
  "description": "<string>",
  "activated": true,
  "created_at": "<string>",
  "updated_at": "<string>",
  "org_id": "<string>",
  "voice_model": "<string>"
}

​
Body

​
agent_name
string
Updated name for the agent.
​
agent_type
string
Updated agent type/preset.
​
description
string
Updated description.
​
role
string
Updated role/persona.
​
instructions
string
Updated system instructions.
​
goal
string
Updated goals/objectives.
​
voice_model
string
Updated voice model.
​
activated
boolean
Activation status.

​
Response

​
agent_name
string
The name of the agent.
​
agent_type
string
The type of the agent.
​
description
string
The description of the agent.
​
activated
boolean
The activation status of the agent.
​
created_at
string
The date and time the agent was created.
​
updated_at
string
The date and time the agent was last updated.
​
org_id
string
The organization ID to which the agent belongs.
​
voice_model
string
The voice model associated with the agent.
curl --location --request PUT 'https://api.stateset.com/v1/agents/agent_123' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <api_key>' \
--data-raw '{
    "agent_name": "Support Bot v2",
    "description": "Updated return and warranty support agent",
    "instructions": "Ask clarifying questions before taking action.",
    "activated": true
}'