GET /api/sessions

GET /api/sessions

List Sessions

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

Parameters

Name	In	Type	Required	Description
`q`	query	string \| null	No	Search query for session titles
`include_archived`	query	boolean	No	Include archived sessions Defaults to `false`.
`limit`	query	integer	No	Max sessions to return Defaults to `50`.
`cursor`	query	string \| null	No	Opaque cursor from a prior next_cursor; omit for first page
`X-Org-ID`	header	string \| null	No	-

Example request

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

Example response

200 application/json

{
  "sessions": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "title": "string",
      "provider": null,
      "model": null,
      "created_at": "2026-06-16T08:30:00Z",
      "updated_at": "2026-06-16T08:30:00Z",
      "message_count": 0,
      "last_message_preview": null,
      "category_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "category_name": "production",
      "category_color": null,
      "category_icon": null,
      "is_pinned": false,
      "is_archived": false,
      "initiated_by": null,
      "unread": false
    }
  ],
  "total": 1,
  "next_cursor": null,
  "has_more": false
}

Responses

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

Parameters

Example request

Example response

Responses

On this page