StateSet API Docs

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

PUT

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

Create Agent Delete Agent

​Body

​Response

Body

Response