Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Delete an agent session

beta.agents.sessions.delete(strsession_id) -> AgentSessionDeleted
DELETE/agents/sessions/{session_id}

Removes a managed agent session from the public API and returns a deletion confirmation. If backend execution has ended, deletion can cancel a still-open public turn and abandon unpublished outputs. Running execution must be cancelled first. Physical cleanup may continue asynchronously. See managing sessions.

ParametersExpand Collapse
session_id: str
minLength0
maxLength1048576
ReturnsExpand Collapse
class AgentSessionDeleted: …

A Managed Agents session removed from the public API. Physical cleanup may continue asynchronously.

id: str

The ID of the deleted session.

minLength0
deleted: bool

Whether the session has been removed from the public API. Always true. Physical cleanup may still be in progress.

object: Literal["agent.session.deleted"]

The object type. Always agent.session.deleted.

Delete an agent session

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),  # This is the default and can be omitted
)
agent_session_deleted = client.beta.agents.sessions.delete(
    "session_id",
)
print(agent_session_deleted.id)
{
  "id": "id",
  "deleted": true,
  "object": "agent.session.deleted"
}
Returns Examples
{
  "id": "id",
  "deleted": true,
  "object": "agent.session.deleted"
}