List customers currently assigned to an agent
Paginated list. The agent must belong to your tenant.
Authorization
ApiKeyAuth API key from your dashboard (Settings > API Keys)
In: header
Path Parameters
Agent id (User cuid2)
Query Parameters
Page number, 0-indexed (first page is 0).
00 <= value201 <= value <= 100Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://loading/api/v1/agents/string/customers"{
"success": true,
"data": {
"total": 0,
"page": 0,
"limit": 0,
"data": [
{
"id": "cus_abc123",
"identifier": "919876543210",
"name": "string",
"waba_id": "string",
"conversation_status": "OPEN"
}
]
}
}{
"success": false,
"message": "user not authenticated"
}{
"success": false,
"message": "forbidden"
}{
"success": false,
"message": "Agent not found"
}{
"success": false,
"message": "internal server error"
}List eligible agents in the tenant POST
Returns the tenant's agents (role=AGENT, parent_id=tenant) with filter and pagination, so external systems can populate agent pickers via API key.
Replace the full agent set for a customer PUT
Sets the customer's assigned agents to exactly the provided list. The server diffs against the current set and applies the necessary adds and removes in one call. Pass an empty `agentIds` array to clear all assignments. Returns three lists: `added`, `removed`, and `unchanged`.


