Skip to main content
GET
/
v1
/
chat
/
agents
List agents
curl --request GET \
  --url https://api.agntix.ai/v1/chat/agents \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "fullName": "Customer Support Bot",
      "description": "Handles tier-1 customer queries",
      "role": "You are a helpful support agent for Acme Inc.",
      "language": "en",
      "voiceEnabled": false,
      "isActive": true,
      "isPublic": false,
      "orgId": "org_2abc123",
      "createdAt": "2026-04-28T11:42:11Z",
      "updatedAt": "2026-04-28T11:42:11Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}
Every endpoint on this page requires either a Clerk-issued JWT (Authorization: Bearer <token>) or an organization API key (x-api-key: pk_…). Anonymous calls return 401 Unauthorized. See Authentication for the full setup.

​
Code examples

curl https://api.agntix.ai/v1/chat/agents \
  -H "x-api-key: pk_live_••••"

​
Sample response

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "fullName": "Customer Support Bot",
      "description": "Handles tier-1 customer queries",
      "language": "en",
      "voiceEnabled": false,
      "isActive": true,
      "isPublic": false,
      "orgId": "org_2abc123",
      "createdAt": "2026-04-28T11:42:11Z",
      "updatedAt": "2026-04-28T11:42:11Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}

Authorizations

​
x-api-key
string
header
required

Organization API key. Obtain from the dashboard. Format: pk_live_…

Query Parameters

​
page
integer
default:1

Page number (1-based).

Required range: x >= 1
​
limit
integer
default:20

Number of results per page (max 100).

Required range: x <= 100
​
search
string

Filter by agent name (case-insensitive substring match).

​
isActive
boolean

Filter by active status.

Response

Paginated list of agents.

​
data
object[]
​
pagination
object