---
title: "Permanently delete a tenant and its workspace data. Requires the `TENANT_DELETE` privilege on the calling credential — the API token, or the signed-in user (Owner role only). A caller without it is refused with 403 (TBP-552, TBP-557). A signed-in user may only delete their own workspace. A workspace with a Stripe subscription has it set to cancel at the end of the current billing period first (no refund, no proration). When the subscription cannot be cancelled the delete is refused (409 or 502) and nothing is removed. `GET :id/deletion-preview` shows what this would remove, without removing it."
method: DELETE
path: "/account/tenant/{id}"
tags: ["account"]
---

# Permanently delete a tenant and its workspace data. Requires the \`TENANT_DELETE\` privilege on the calling credential — the API token, or the signed-in user (Owner role only). A caller without it is refused with 403 (TBP-552, TBP-557). A signed-in user may only delete their own workspace. A workspace with a Stripe subscription has it set to cancel at the end of the current billing period first (no refund, no proration). When the subscription cannot be cancelled the delete is refused (409 or 502) and nothing is removed. \`GET :id/deletion-preview\` shows what this would remove, without removing it.

`DELETE /account/tenant/{id}`

## 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/tenant/{id}`
- Auth: none declared

## Path parameters

- `id` 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)