Agents

List your configured AI agents.

List agents

GET /v1/agents

Retrieve all active AI agents in your organization.

Required scope: agents:read

Query parameters

Parameter	Type	Description
page	integer	Page number (default: 1)
limit	integer	Results per page (default: 20, max: 100)

Example

curl "https://api.replicer.ai/v1/agents" \
  -H "Authorization: Bearer rpl_live_your_key"

Response 200 OK

{
  "data": [
    {
      "id": "clx-agent-001",
      "agentName": "Sales Agent",
      "agentType": "outbound_sales",
      "callDirection": "OUTBOUND",
      "voiceId": "voice-natural-en-1",
      "language": "en",
      "isActive": true,
      "createdAt": "2026-01-15T10:00:00Z"
    },
    {
      "id": "clx-agent-002",
      "agentName": "Customer Support",
      "agentType": "support",
      "callDirection": "INBOUND",
      "voiceId": "voice-friendly-en-2",
      "language": "en",
      "isActive": true,
      "createdAt": "2026-02-20T14:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "totalPages": 1
  },
  "requestId": "req-abc123"
}

Agent fields

Field	Type	Description
id	string	Unique agent ID — use this in Create Call
agentName	string	Display name of the agent
agentType	string	Agent type (e.g., outbound_sales, support)
callDirection	string	INBOUND or OUTBOUND
voiceId	string	Default voice ID
language	string	Default language code
isActive	boolean	Always true (only active agents are returned)
createdAt	string	ISO 8601 creation timestamp

TIP

Use the id from an agent in this list as the agentId when creating a call.