Skip to main content
DELETE
Permanently deletes a flag and republishes your configuration without it. The key becomes available for reuse.
This cannot be undone. If you only want servers to stop seeing the flag, use PATCH /flags/{flagId} with "archived": true instead — the flag is kept and its key stays reserved.

Authorization

string
required
Bearer token for authentication. Format: Bearer <your-api-key>

Required Permission

FLAGS_WRITE

Path Parameters

string
required
The flag’s UUID.

Response

string
Confirmation message.

Status Codes

Deleting is deliberately allowed on a locked flag — removing one is how you get back under your allowance without subscribing again.
Servers reading a deleted flag fall back rather than throwing, so deleting one can never crash a running server.