Delete Conversation

This endpoint deletes a single conversation by its unique identifier. Use this for destructive data removal. For normal call cleanup when a user leaves or a session is finished, use End Conversation instead.

DELETE /v2/conversations/{conversation_id}

Delete Conversation

cURL

curl --request DELETE \
  --url https://tavusapi.com/v2/conversations/{conversation_id} \
  --header 'x-api-key: <api-key>'

400

{
  "error": "Invalid conversation_id"
}

For AI agents, use https://docs.tavus.io/openapi.yaml for the full HTTP API contract.

Authorizations

x-api-key · string · header · required

Path Parameters

conversation_id · string · required

The unique identifier of the conversation.

Example:

"c123456"

Query Parameters

hard · boolean

If set to true, the conversation and associated assets will be hard deleted. CAUTION: This action is irrevocable.

Example:

true

Response

204

NO CONTENT