API Reference

Beta

Agents

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete an agent

DELETE/agents/{agent_id}

Deletes a reusable agent. See agent configuration.

Path ParametersExpand Collapse

agent_id: string

minLength0

maxLength1048576

ReturnsExpand Collapse

AgentDeleted object { id, deleted, object }

A deleted reusable agent.

id: string

The ID of the deleted agent.

minLength0

deleted: boolean

Whether the agent was deleted. Always true.

object: "agent.deleted"

The object type. Always agent.deleted.

Delete an agent

HTTP

HTTP

Python

TypeScript

Go

Ruby

Java

CLI Tool

curl https://api.openai.com/v1/agents/$AGENT_ID \
    -X DELETE \
    -H 'OpenAI-Beta: agents=v1' \
    -H "Authorization: Bearer $OPENAI_API_KEY"

200 example

{
  "id": "id",
  "deleted": true,
  "object": "agent.deleted"
}

Returns Examples

200 example

{
  "id": "id",
  "deleted": true,
  "object": "agent.deleted"
}