Skip to main content
// 404 - Session not found
{
  "error": "Session not found",
  "code": "SESSION_NOT_FOUND",
  "details": {
    "sessionId": "abc-123"
  }
}
This endpoint immediately ends a session regardless of its timeout configuration. The session is removed from memory but the underlying channel and messages are preserved for historical reference.

Path Parameters

sessionId
string
required
The unique identifier of the session to delete

Response

success
boolean
Whether the session was successfully deleted
message
string
Confirmation message with the session ID

Example Response

{
  "success": true,
  "message": "Session abc-123-def-456 deleted successfully"
}

Error Responses

// 404 - Session not found
{
  "error": "Session not found",
  "code": "SESSION_NOT_FOUND",
  "details": {
    "sessionId": "abc-123"
  }
}

Important Notes

  • Deleting a session does not delete the conversation history
  • The underlying channel and messages remain in the database
  • Active WebSocket connections for the session will be terminated
  • Any pending operations on the session will fail after deletion