Delete Session Endpoint
Delete one of the caller’s sessions — DELETE /api/v1/sessions/{session_id}.
Removes the session’s Q&A turns, agent traces, session context and watermarks, its Q&A vectors, and its dashboard and usage rows. Only the caller’s own sessions: read access to a session through a dataset grant does not allow deleting it. Lessons already distilled from the session into a dataset stay; delete them with POST /api/v1/forget and their data id.
Path Parameters
- session_id (str): The session to delete.
Response
{"session_id": ..., "deleted": true}; 404 when the caller has no such
session; 422 when session memory is disabled (CACHING=false).
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Client-supplied session identifier; the same value passed as session_id to POST /api/v1/remember.
"claude-code-1718000000"
Response
Successful Response