Skip to main content
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

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

​
Response

​
ok
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>"

​
Errors

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