---
title: "Delete an agent that never reached Google"
method: DELETE
path: "/v1/agents/{id}"
tags: ["Agents"]
---

# Delete an agent that never reached Google

`DELETE /v1/agents/{id}`

## Request

- Base URL: `https://api.cadencercs.com`
- URL: `https://api.cadencercs.com/v1/agents/{id}`
- Auth: HTTP bearer

Narrow on purpose. Once the agent exists at Google it **cannot be deleted by anyone** — Google deprecated agent deletion for RBM and routes it through their support — so removing our record would orphan theirs invisibly, which is worse than the growing list this exists to trim. Drafts with no traffic only.

## Path parameters

- `id` string, required

## Response `200`

Deleted.

- object
  - `ok` boolean, required
  - `deleted` string

## Other responses

- `401`: Not signed in, and no account-linked API key was sent.
- `404`: No such agent on this account.
- `409`: It exists at Google (`AGENT_EXISTS_AT_GOOGLE`), isn't a draft (`AGENT_NOT_DRAFT`), or has conversations against it (`AGENT_HAS_TRAFFIC`) — those transcripts are someone's messages and the consent record points at this agent.
- `500`: Unexpected server error. The body is always JSON.

---

[API](https://skmtc.dev/cadencercs/apis/cadence-api.md) · [All operations](https://skmtc.dev/cadencercs/apis/cadence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cadencercs/apis/cadence-api/revisions/9438443c2081?raw)