List Agents

This endpoint gets agents

GET /v1/agents

cURL

curl --location --request GET 'https://api.stateset.com/v1/agents?limit=20&offset=0' \
--header 'Authorization: Bearer <api_key>'

Response

[
  {
    "id": "agent_123",
    "agent_name": "Support Bot",
    "agent_type": "Conversational AI Agent",
    "description": "Handles order status and returns",
    "activated": true,
    "org_id": "org_456"
  }
]

Query Parameters (optional)

limit · number

Number of agents to return. Defaults to 20.

offset · number

Offset for pagination. Defaults to 0.

Response

agent_name · string

The name of the created agent.

agent_type · string

The type of the created agent.

description · string

The description of the created agent.

activated · string

The activation status of the created 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.

voice_model_id · string

The voice model ID associated with the agent.

cURL

curl --location --request GET 'https://api.stateset.com/v1/agents?limit=20&offset=0' \
--header 'Authorization: Bearer <api_key>'

Response

[
  {
    "id": "agent_123",
    "agent_name": "Support Bot",
    "agent_type": "Conversational AI Agent",
    "description": "Handles order status and returns",
    "activated": true,
    "org_id": "org_456"
  }
]