Clear session history

Clear all messages from a chat session

POST /v1/chat/sessions/{id}/clear

Clear session history

cURL

curl --request POST \
  --url http://co-mind-platform-host/v1/chat/sessions/{id}/clear \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "session_xyz789",
  "object": "chat.session",
  "message_count": 0,
  "cleared": true
}

Authorizations

Authorization · string · header · required

Bearer token authentication. Supports two token types:

• JWT Access Token — obtained via POST /v1/auth/login
• Personal Access Token (PAT) — created via POST /v1/api-tokens, format: cmnd_<tokenId>.<secret>

Path Parameters

id · string · required

The session ID

Response

200

application/json

Session history cleared successfully

id · string

Example:

"session_xyz789"

object · string

Example:

"chat.session"

message_count · integer

Example:

0

cleared · boolean

Example:

true