---
title: "Delete a billing plan by reference (TBP-806). Only a plan no workspace is on; one that workspaces are on is refused with 409 `PLAN_IN_USE` and what to do instead (archive it, or move or delete those workspaces first). Requires the `APP_DELETE` privilege on the calling API token. Destructive privileges are opt-in and are never granted by default, so a token without it is refused with 403 (TBP-552)."
method: DELETE
path: "/account/payments/plan/{ref}"
tags: ["account"]
---

# Delete a billing plan by reference (TBP-806). Only a plan no workspace is on; one that workspaces are on is refused with 409 \`PLAN_IN_USE\` and what to do instead (archive it, or move or delete those workspaces first). Requires the \`APP_DELETE\` privilege on the calling API token. Destructive privileges are opt-in and are never granted by default, so a token without it is refused with 403 (TBP-552).

`DELETE /account/payments/plan/{ref}`

## Request

- Base URL: `https://api.thebridge.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebridge.dev/account/payments/plan/{ref}`
- Auth: none declared

## Path parameters

- `ref` string, required

## Response `200`

---

[API](https://skmtc.dev/thebridge/apis/bridge-api.md) · [All operations](https://skmtc.dev/thebridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebridge/apis/bridge-api/revisions/290fffcb3d80?raw)