Skip to main content
POST
/
v1
/
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

​
agent_name
string
Human‑readable name for the agent.
​
agent_type
string
Agent type/preset (e.g., “Conversational AI Agent”). Defaults to conversational.
​
description
string
Short purpose/description shown in the dashboard.
​
role
string
High‑level role or persona for the agent.
​
instructions
string
System instructions that guide the agent’s behavior.
​
goal
string
Primary objective(s) the agent should optimize for.
​
voice_model
string
Voice model to use for voice channels (if enabled).
​
activated
boolean
Whether the agent is active immediately. Defaults to true.
​
org_id
string
Organization/workspace that owns the agent. If omitted, uses your current org.

​
Response

​
id
string
Unique identifier for the agent.
​
agent_name
string
The name of the created agent.
​
agent_type
string
The agent type/preset.
​
description
string
The description of the created agent.
​
role
string
The role/persona of the agent.
​
activated
boolean
Whether the agent is active.
​
org_id
string
Organization/workspace that owns the agent.
​
voice_model
string
Voice model configured for the agent.
​
created_at
string
When the agent was created.
​
updated_at
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"
}'