---
title: "Permanently delete a feature flag and its rules. Requires the `FLAG_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). `GET flag/:flagId/deletion-preview` shows what this would remove, without removing it."
method: DELETE
path: "/v1/admin/flags/flag/{flagId}"
tags: ["admin"]
---

# Permanently delete a feature flag and its rules. Requires the \`FLAG_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). \`GET flag/:flagId/deletion-preview\` shows what this would remove, without removing it.

`DELETE /v1/admin/flags/flag/{flagId}`

## 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/v1/admin/flags/flag/{flagId}`
- Auth: none declared

## Path parameters

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