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(agent_id) -> AgentDeleted { id, deleted, object }

DELETE/agents/{agent_id}

Deletes a reusable agent. See agent configuration.

ParametersExpand Collapse

agent_id: String

minLength0

maxLength1048576

ReturnsExpand Collapse

class AgentDeleted { id, deleted, object }

A deleted reusable agent.

id: String

The ID of the deleted agent.

minLength0

deleted: bool

Whether the agent was deleted. Always true.

object: :"agent.deleted"

The object type. Always agent.deleted.

Delete an agent

Ruby

HTTP

Python

TypeScript

Go

Ruby

Java

CLI Tool

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

agent_deleted = openai.beta.agents.delete("agent_id")

puts(agent_deleted)

200 example

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

Returns Examples

200 example

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