Agent Contexts / Delete

Delete Agent Context

Permanently delete an agent context and its conversation history. Use this endpoint when users request data deletion, to clean up completed sessions, or to free up resources. This operation is irreversible.

DELETE {baseAPIUrl}/agent-contexts/:id

Authentication

Required. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Path Parameters

ParameterTypeDescription
idstring (UUID)The unique identifier of the agent context to delete

Query Parameters

ParameterTypeRequiredDescription
appIdstringRequiredApplication identifier
externalUserIdstringRequiredExternal user identifier

Response

{
  "success": true
}

Warning: This action is irreversible. Once deleted, the agent context cannot be recovered.

Try It

Path Parameters

Agent context ID (UUID)

Query Parameters

Application identifier

External user identifier