end-session.mdx

title	description	openapi
End Session	Explicitly end and delete a conversation session	delete /api/messaging/sessions/{sessionId}

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

The unique identifier of the session to delete

Response

Whether the session was successfully deleted Confirmation message with the session ID

Example Response

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

Error Responses

```json // 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