Skip to main content

​
DELETE /api/v1/session/

Permanently deletes a session and all associated data, including documentation items, job records, and session data. This operation cannot be undone.

​
Path Parameters

​
session_id
string
required
The UUID of the session to delete

​
Response

​
message
string
Success message indicating the session was deleted
​
sessionId
string
The UUID of the deleted session

​
Example Request

curl -X DELETE http://localhost:8090/api/v1/session/550e8400-e29b-41d4-a716-446655440000

​
Example Response

{
  "message": "Session deleted successfully",
  "sessionId": "550e8400-e29b-41d4-a716-446655440000"
}

​
Error Responses

​
404
error
Session not found
{
  "detail": "Session 550e8400-e29b-41d4-a716-446655440000 not found"
}

​
Notes

  • This operation permanently deletes the session and cannot be undone
  • All associated data is removed, including:
    • Documentation items and chunks
    • Job records and progress data
    • Session data (inputs, outputs, intermediate results)
  • Active jobs associated with the session may continue running but their results will not be saved
Once deleted, a session cannot be recovered. Make sure to export any needed data before deletion.

Build docs developers (and LLMs) love

Get started for freeTalk to us