Delete a session and its events

Deleting a session removes the session record and all associated events from Knoq. If a background workflow is actively processing a turn when you issue this request, Knoq marks the session as cancelled first so the workflow exits cleanly before the data is removed. Deletion is permanent and cannot be undone.

Deleting a session in Knoq removes only the locally persisted data — conversation history stored on Knoq’s side. This action does not affect any data held by external AI providers.

DELETE /api/managed-agents/session?sessionId=<id>

Request

string

required

The ID of the session to delete. You can obtain this from the Create Session response or the List Sessions endpoint.

Response

boolean

Always true when the deletion succeeds.

Example

curl -X DELETE \
  "https://knoq.one/api/managed-agents/session?sessionId=a3f2c1d4-e5b6-7890-abcd-ef1234567890" \
  -H "Origin: https://knoq.one" \
  -H "Cookie: <your-session-cookie>"

{
  "ok": true
}

Errors

Status	Meaning
`400`	The `sessionId` query parameter is missing or empty.
`401`	The request is not authenticated. Ensure your session cookie is valid and has not expired.
`404`	No session with the given ID was found for your user and organisation. The session may have already been deleted.

Overview

Sessions

Messaging

SCIM Provisioning

Delete a session and its events

Request

Response

Example

Errors

​Request

​Response

​Example

​Errors

Request

Response

Example

Errors