CognitiveX Docs
API

GET /api/sessions/categories

List Categories

GET /api/sessions/categories

List Categories

Authentication: Authorization: Bearer <key> or X-API-Key: <key>. Create keys at developers.cognitivx.io/keys.

Parameters

NameInTypeRequiredDescription
X-Org-IDheaderstring | nullNo-

Example request

curl -X GET https://api.cognitivx.io/api/sessions/categories \
  -H "Authorization: Bearer icog_..."

Example response

200 application/json

{
  "categories": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "production",
      "position": 1,
      "color": "#8b5cf6",
      "icon": "folder",
      "created_at": "2026-06-16T08:30:00Z",
      "updated_at": "2026-06-16T08:30:00Z"
    }
  ]
}

Responses

StatusDescription
200Success. Returns the response body shown below.
422Request validation failed. detail lists each offending field.