> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Agent

> This endpoint creates a new agent

### Body

<ParamField body="agent_name" type="string">
  Human‑readable name for the agent.
</ParamField>

<ParamField body="agent_type" type="string" optional="true">
  Agent type/preset (e.g., "Conversational AI Agent"). Defaults to conversational.
</ParamField>

<ParamField body="description" type="string" optional="true">
  Short purpose/description shown in the dashboard.
</ParamField>

<ParamField body="role" type="string" optional="true">
  High‑level role or persona for the agent.
</ParamField>

<ParamField body="instructions" type="string" optional="true">
  System instructions that guide the agent’s behavior.
</ParamField>

<ParamField body="goal" type="string" optional="true">
  Primary objective(s) the agent should optimize for.
</ParamField>

<ParamField body="voice_model" type="string" optional="true">
  Voice model to use for voice channels (if enabled).
</ParamField>

<ParamField body="activated" type="boolean" optional="true">
  Whether the agent is active immediately. Defaults to `true`.
</ParamField>

<ParamField body="org_id" type="string" optional="true">
  Organization/workspace that owns the agent. If omitted, uses your current org.
</ParamField>

### Response

<ResponseField name="id" type="string">
  Unique identifier for the agent.
</ResponseField>

<ResponseField name="agent_name" type="string">
  The name of the created agent.
</ResponseField>

<ResponseField name="agent_type" type="string">
  The agent type/preset.
</ResponseField>

<ResponseField name="description" type="string">
  The description of the created agent.
</ResponseField>

<ResponseField name="role" type="string">
  The role/persona of the agent.
</ResponseField>

<ResponseField name="activated" type="boolean">
  Whether the agent is active.
</ResponseField>

<ResponseField name="org_id" type="string">
  Organization/workspace that owns the agent.
</ResponseField>

<ResponseField name="voice_model" type="string">
  Voice model configured for the agent.
</ResponseField>

<ResponseField name="created_at" type="string">
  When the agent was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  When the agent was last updated.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  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"
  }'
  ```
</RequestExample>