OpenAI API (unofficial showcase)
DELETE/conversations/{conversation_id}/items/{item_id}

Delete an item from a conversation

Deletes an item from a conversation. Use conversation_id and item_id to identify the item to remove.

2 parameters
conversation_idstringrequired
The identifier of the conversation that contains the item.
item_idstringrequired
The identifier of the item to delete.

5 status codes
200Returns the conversation object, including its identifier, metadata, and creation time.
idstringrequired
The unique ID of the conversation.
objectstringrequired
The object type, which is always `conversation`.
Allowed:conversationDefault:conversation
metadataobjectrequired
Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.
created_atintegerrequired
The time at which the conversation was created, measured in seconds since the Unix epoch.
400Returned when the item cannot be removed while the conversation is locked.
errorobjectrequired
404Returned when the conversation or the item in that conversation was not found.
errorobjectrequired
429Returned when the request exceeds a rate limit.
errorobjectrequired
500Returned when the conversation update could not be finalized.
errorobjectrequired

Error handling

A 400 is returned when the item cannot be removed because the conversation is locked. A 404 is returned when the conversation or the item in that conversation was not found. A 429 is returned when the request exceeds a rate limit, and a 500 is returned when the conversation update cannot be finalized. The conversation_id and item_id path parameters must identify the conversation and item to delete.