API Reference

Beta

Agents

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete an agent

beta.agents.delete(stragent_id) -> AgentDeleted

DELETE/agents/{agent_id}

Deletes a reusable agent. See agent configuration.

ParametersExpand Collapse

agent_id: str

minLength0

maxLength1048576

ReturnsExpand Collapse

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

Python

HTTP

Python

TypeScript

Go

Ruby

Java

CLI Tool

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"
}