List labels

Labels are tags you can apply to assistants. Unlike folders, an assistant can have multiple labels, and a label can be applied to many assistants. Labels are private to your account.

This endpoint returns your labels (paginated), each with the number of assistants it is applied to.

Query Parameters

Response fields

{
  "data": [
    { "id": 3, "name": "Inbound", "color": "green", "assistants_count": 7 },
    { "id": 5, "name": "Outbound", "color": "blue", "assistants_count": 2 }
  ],
  "current_page": 1,
  "per_page": 15,
  "total": 2
}