API Reference

Labels & Tags API

Create, list, and assign organizational classification labels, hex colors, and routing queues via the Intellectua REST API.

GET
/v1/labelsList all organization labels

Response Fields

data[].idstring
data[].namestring
data[].colorstring (Hex)
data[].documentCountinteger
Example Response200 OK
{
  "data": [
    {
      "id": "lbl_ortho_123",
      "name": "Orthopedics",
      "color": "#3b82f6",
      "description": "Musculoskeletal and sports medicine consults",
      "documentCount": 24,
      "createdAt": "2026-09-20T10:00:00.000Z"
    },
    {
      "id": "lbl_stat_456",
      "name": "STAT Priority",
      "color": "#ef4444",
      "description": "Immediate same-day clinical physician review required",
      "documentCount": 3,
      "createdAt": "2026-09-20T10:05:00.000Z"
    }
  ]
}
POST
/v1/labelsCreate new classification label

Request Body Parameters

namestring (Required)

Descriptive label tag name

colorstring (Optional)

Hex color code for badge display (default: #6366f1)

descriptionstring (Optional)

Internal workflow guidance for clinic staff

Example Create Response201 Created
{
  "id": "lbl_cardio_789",
  "organizationId": "org_main_clinic",
  "name": "Cardiology",
  "color": "#ec4899",
  "description": "Echocardiograms and cardiac stress testing reports",
  "createdAt": "2026-09-21T21:50:00.000Z"
}