Conversations

Delete a conversation

DELETE

/openai/v1/conversations/{conversation_id}

Removes the specified conversation resource from the current project.

Path Parameters

conversation_idstringrequired

The id of the conversation to delete.

Header Parameters

x-ms-user-identitystringoptional

Opaque per-user identity string used to scope endpoint-scoped data to a specific end user. The caller must have the agents/endpoints/UserIdentityImpersonation/action RBAC permission.

Responses

objectenumrequired

conversation.deleted

deletedbooleanrequired

idstringrequired

View as Markdown

Request

Language

curl -X DELETE https://api.openai.com/v1/conversations/conv_123 \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Response

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