Delete an agent

DELETE

/agents/{agent_id}

Deletes a reusable agent. See agent configuration.

HTTP

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

agent_id: string

The ID of the reusable agent.

minLength0

maxLength1048576

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" (default: "agent.deleted")

The object type. Always agent.deleted.

200 — Example

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