End Session

Explicitly end and delete a conversation session

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