API
PUT /api/sessions/{session_id}/pin
Toggle Session Pin
PUT /api/sessions/{session_id}/pin
Toggle Session Pin
Authentication: Authorization: Bearer <key> or X-API-Key: <key>. Create keys at developers.cognitivx.io/keys.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
session_id | path | string | Yes | - |
X-Org-ID | header | string | null | No | - |
Example request
curl -X PUT https://api.cognitivx.io/api/sessions/{session_id}/pin \
-H "Authorization: Bearer icog_..."Example response
200 application/json
{
"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
}Responses
| Status | Description |
|---|---|
200 | Success. Returns the response body shown below. |
422 | Request validation failed. detail lists each offending field. |