v1

latestOpenAPI 3.0.1Apache 2.02026-07-1398228598.3 KB

Label

List Labels

Retrieves a paginated list of labels for the authenticated organization. Labels are used to categorize conversations and drive AI flows, scorecard criteria, and intelligence-item-collection criteria. Only labels belonging to the caller's organization are returned.

get/labels

Query parameters

pageinteger

1-indexed page number to return. Defaults to 1.

sizeinteger

Number of labels per page. Defaults to 50. Maximum 200.

Response

Labels successfully retrieved

Example response

{
  "data": [
    {
      "uuid": "fe515723-fe2e-4959-a5fa-c4d3937fe7e4",
      "name": "Buying Signal",
      "description": "Conversations where the prospect expresses a buying signal.",
      "aiFlow": true,
      "allTeams": false,
      "isDefaultTemplate": false,
      "options": [],
      "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
      "createdAt": "2026-04-16T18:00:00Z"
    }
  ],
  "meta": {
    "pageCount": 1,
    "totalRecords": 1,
    "pageNumber": 1,
    "pageSize": 50
  }
}