Sample - OpenAI API
DELETE/conversations/{conversation_id}/items/{item_id}

Delete a conversation item

Deletes a specific item from a conversation. Use conversation_id and item_id together to identify the item to remove. The response returns a conversation object after the deletion operation.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
conversation_idstringrequired
The unique identifier of the conversation containing the item.
item_idstringrequired
The unique identifier of the conversation item to delete.

2 status codes
200Returns a conversation object containing its identifier, object type, metadata, and creation timestamp.
idstringrequired
The unique ID of the conversation.
objectstringrequired
The object type, which is always `conversation`.
Allowed:conversationDefault:conversation
metadataunknownrequired
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.
429Returned when the request was rejected because a rate limit was exceeded.
errorobjectrequired

Error handling

A 429 is returned when the request rate exceeds the allowed limit. Both conversation_id and item_id must identify the conversation item targeted for deletion.