StateSet API Docs

curl --location --request POST 'https://api.stateset.com/v1/agents' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <api_key>' \
--data-raw '{
    "agent_name": "Support Bot",
    "agent_type": "Conversational AI Agent",
    "description": "Handles order status and returns",
    "role": "Customer Support Specialist",
    "instructions": "Be concise, friendly, and ask for an order number when needed.",
    "goal": "Resolve customer issues quickly",
    "voice_model": "Asteria"
}'

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

POST

agents

curl --location --request POST 'https://api.stateset.com/v1/agents' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <api_key>' \
--data-raw '{
    "agent_name": "Support Bot",
    "agent_type": "Conversational AI Agent",
    "description": "Handles order status and returns",
    "role": "Customer Support Specialist",
    "instructions": "Be concise, friendly, and ask for an order number when needed.",
    "goal": "Resolve customer issues quickly",
    "voice_model": "Asteria"
}'

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

Body

string

Human‑readable name for the agent.

string

Agent type/preset (e.g., “Conversational AI Agent”). Defaults to conversational.

string

Short purpose/description shown in the dashboard.

string

High‑level role or persona for the agent.

string

System instructions that guide the agent’s behavior.

string

Primary objective(s) the agent should optimize for.

string

Voice model to use for voice channels (if enabled).

boolean

Whether the agent is active immediately. Defaults to true.

string

Organization/workspace that owns the agent. If omitted, uses your current org.

Response

string

Unique identifier for the agent.

string

The name of the created agent.

string

The agent type/preset.

string

The description of the created agent.

string

The role/persona of the agent.

boolean

Whether the agent is active.

string

Organization/workspace that owns the agent.

string

Voice model configured for the agent.

string

When the agent was created.

string

When the agent was last updated.

curl --location --request POST 'https://api.stateset.com/v1/agents' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <api_key>' \
--data-raw '{
    "agent_name": "Support Bot",
    "agent_type": "Conversational AI Agent",
    "description": "Handles order status and returns",
    "role": "Customer Support Specialist",
    "instructions": "Be concise, friendly, and ask for an order number when needed.",
    "goal": "Resolve customer issues quickly",
    "voice_model": "Asteria"
}'

Get Agent Update Agent

​Body

​Response

Body

Response