API Reference

Beta

Agents

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete an agent

client.Beta.Agents.Delete(ctx, agentID) (*AgentDeleted, error)

DELETE/agents/{agent_id}

Deletes a reusable agent. See agent configuration.

ParametersExpand Collapse

agentID string

minLength0

maxLength1048576

ReturnsExpand Collapse

type AgentDeleted struct{…}

A deleted reusable agent.

ID string

The ID of the deleted agent.

minLength0

Deleted bool

Whether the agent was deleted. Always true.

Object AgentDeleted

The object type. Always agent.deleted.

Delete an agent

Go

HTTP

Python

TypeScript

Go

Ruby

Java

CLI Tool

package main

import (
  "context"
  "fmt"

  "github.com/openai/openai-go"
  "github.com/openai/openai-go/option"
)

func main() {
  client := openai.NewClient(
    option.WithAPIKey("My API Key"),
  )
  agentDeleted, err := client.Beta.Agents.Delete(context.TODO(), "agent_id")
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", agentDeleted.ID)
}

200 example

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

Returns Examples

200 example

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