API reference · Agents
Delete an agent
DELETE/v1/agents/{id}API key
Its keys stop at once and what it can spend returns to the account; money held by a request in flight follows when that request settles. Its ledger rows stay.
Parameters
| Field | Type | What it is |
|---|---|---|
| id (path)required | string | The agent's id; self on an agent's own key where the route allows it. |
Answer 200
Deleted.
| Field | Type | What it is |
|---|---|---|
| id | integer | |
| object | string | One of "agent.deleted". |
| deleted | boolean | |
| returned_micros | integer | Moved back to the account now. |
| still_held_micros | integer | Held by requests in flight; returned once they settle. |
Errors
- 401OpenAI shaped error.
- 403OpenAI shaped error.
- 404OpenAI shaped error.
Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.