Update Agent

This endpoint updates an agent

PUT /v1/agents/{id}

cURL

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

200

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

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