Skip to content
Get an API key

API reference

Delete a conversation.

DELETE
/conversations/{conversation_id}
curl --request DELETE \
--url https://api.helping.io/v1/conversations/example \
--header 'Authorization: Bearer <token>'

The conversation and its history stop being reachable and it can no longer be continued. Deleting twice is not an error.

conversation_id
required
string

The opaque conv_... id of the conversation

{id, object: "conversation.deleted", deleted: true}.

Media typeapplication/json

The answer to a conversation delete.

object
deleted
required

Always true.

boolean
id
required

The conversation’s opaque id, echoed from the request.

string
object
required

Always conversation.deleted.

string
Examplegenerated
{
"deleted": true,
"id": "example",
"object": "example"
}

Missing or invalid API key (the error envelope)

The key is not entitled to what the request asked for (the error envelope)

No such conversation, or one this key cannot reach.

This organization has exhausted its delete allowance; retry after the Retry-After header.

The request could not be completed; quote the x-request-id response header when reporting it.

The request could not be served this instant; retry after the Retry-After header.