Model

Delete a conversation

Delete a conversation.

Call Create conversation first, then replace conv_123 with the returned conv_ ID.

DELETE /model/v1/conversations/{conversation_id}● Supported

Official docs ↗

Request parameters

  • conversation_idstring必填

    path: Id of the conversation, the `id` of the object returned by createConversation (it looks like conv_...). Another tenant's conversation, an unknown id and a deleted conversation all answer 404 conversation_not_found.

Returns

200 conversation.deleted

Deletes a conversation. Afterwards neither it nor its items can be referenced again (including as the conversation parameter of Responses create).

Platform errors (auth, rate limits, validation) and OCR errors use problem+json; other model call errors follow the endpoint's own format (OpenAI or Anthropic) — see error codes

Response

HTTP 200

Deletion confirmation

application/json

NameTypeDescription
idstringId of the deleted conversation.
objectstringObject type; always `conversation.deleted`.
deletedbooleanAlways true; neither the conversation nor its items can be referenced again.