Skip to main content
DELETE
/
v1
/
conversations
/
{conversation_id}
Delete or cancel conversation
curl --request DELETE \
  --url https://api.coval.dev/v1/conversations/{conversation_id} \
  --header 'X-API-Key: <api-key>'
{
  "conversation": {
    "name": "conversations/gk3jK9mPq2xRt5vW8yZaBc",
    "conversation_id": "gk3jK9mPq2xRt5vW8yZaBc",
    "status": "DELETED",
    "create_time": "2025-11-03T14:32:30Z"
  }
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication.

Path Parameters

​
conversation_id
string
required

Unique conversation identifier

Required string length: 22 - 26

Response

Conversation deleted or cancelled successfully

​
conversation
object
required

Conversation resource with updated status.

Status will be either CANCELLED or DELETED depending on original status.