Remove an item from a conversation.

DELETE

/conversations/{conversation_id}/items/{item_id}

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

Only items you added can be removed. The answer is the conversation.

Authorizations

• api_key

Parameters

Path Parameters

conversation_id

required

string

The opaque conv_... id of the conversation

item_id

required

string

The item’s id, as the item list returned it

Responses

200

The conversation the item was removed from.

Media typeapplication/json

A conversation.

OpenAI requires all four fields, so none of them is optional here and none is skipped when empty. metadata in particular: a conversation with no labels answers with {}, never with the field absent.

object

created_at

required

When the conversation was created, in seconds since the Unix epoch.

integer format: int64

id

required

The conversation’s opaque id, conv_....

string

metadata

required

The customer’s own labels on this conversation.

object

object

required

Always conversation.

string

Example^generated

{
  "created_at": 1,
  "id": "example",
  "metadata": {},
  "object": "example"
}

400

The item was produced by a response and cannot be removed (the error envelope)

401

Missing or invalid API key (the error envelope)

403

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

404

No such conversation or item, or one this key cannot reach.

429

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

500

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

503

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