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
Theme

Delete an agent

beta.agents.delete(agent_id) -> AgentDeleted
DELETE
/agents/{agent_id}

Deletes a reusable agent. See agent configuration.

Parameters
agent_id: str
minLength0
maxLength1048576
Returns
class AgentDeleted: …

A deleted reusable agent.

id: str

The ID of the deleted agent.

minLength0
deleted: bool

Whether the agent was deleted. Always true.

object: Literal["agent.deleted"]

The object type. Always agent.deleted.

Delete an agent

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_deleted = client.beta.agents.delete(
    "agent_id",
)
print(agent_deleted.id)
200 — Example
{
  "id": "id",
  "deleted": true,
  "object": "agent.deleted"
}
Returns Examples
200 — Example
{
  "id": "id",
  "deleted": true,
  "object": "agent.deleted"
}