Skip to content
API Reference
Conversations

Delete a conversation

conversations.delete(strconversation_id) -> ConversationDeletedResource
DELETE/conversations/{conversation_id}

Delete a conversation. Items in the conversation will not be deleted.

ParametersExpand Collapse
conversation_id: str
ReturnsExpand Collapse
class ConversationDeletedResource: …
id: str
deleted: bool
object: Literal["conversation.deleted"]

Delete a conversation

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),  # This is the default and can be omitted
)
conversation_deleted_resource = client.conversations.delete(
    "conv_123",
)
print(conversation_deleted_resource.id)
{
  "id": "id",
  "deleted": true,
  "object": "conversation.deleted"
}
Returns Examples
{
  "id": "id",
  "deleted": true,
  "object": "conversation.deleted"
}