API Reference

Beta

Agents

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete an agent

AgentDeleted beta().agents().delete(AgentDeleteParamsparams = AgentDeleteParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

DELETE/agents/{agent_id}

Deletes a reusable agent. See agent configuration.

ParametersExpand Collapse

AgentDeleteParams params

Optional<String> agentId

minLength0

maxLength1048576

ReturnsExpand Collapse

class AgentDeleted:

A deleted reusable agent.

String id

The ID of the deleted agent.

minLength0

boolean deleted

Whether the agent was deleted. Always true.

JsonValue; object_ "agent.deleted"constant"agent.deleted"constant

The object type. Always agent.deleted.

Delete an agent

Java

HTTP

Python

TypeScript

Go

Ruby

Java

CLI Tool

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.beta.agents.AgentDeleteParams;
import com.openai.models.beta.agents.AgentDeleted;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.fromEnv();

        AgentDeleted agentDeleted = client.beta().agents().delete("agent_id");
    }
}

200 example

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

Returns Examples

200 example

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