Delete a flag
Permanently deletes a flag from every environment. Evaluating the key afterwards returns FLAG_NOT_FOUND.
Requires a management key.
Returns 404 if no flag has this key.
bearerAuthorizationBearer <token>Send a credential in the Authorization header: Authorization: Bearer <token>.
Each credential belongs to one environment of one workspace, so the API never takes a workspace or environment in the URL.
- Management key (
ffk_…, secret): manages flags, segments, environments, and API keys, and reads the audit log and analytics. It can also do everything an evaluation key can. - Evaluation key (
ffk_…, secret): for server SDKs. It evaluates flags, reads flag definitions for local evaluation, and sends telemetry. - Public token (
ffp_…, not secret): for browser and mobile apps. It evaluates flags through OFREP and sends telemetry. It cannot read flag definitions.
Keep secret keys on your server. A 401 response means the credential is missing or not valid. A 403 response means the credential is valid but its role cannot perform the operation.
key*stringThe flag key, such as new-checkout.
No content
curl -X DELETE 'https://api.toggld.io/api/v1/flags/string'Replace a flag PUT
Replaces a flag with the request body. Omitted optional fields reset to their defaults. To change only some fields, use the update a flag endpoint instead. The name, description, tags, and metadata change in every environment. The variants, enabled state, and targeting rules change only in the credential's environment. The flag type cannot change. Requires a management key. Returns `404` if no flag has this key, `409` if `expectedVersion` does not match the current version, and `422` if the result is not valid.
List tags GET
Returns every distinct tag used by flags in the workspace. Use it to build tag filters for the list flags endpoint. Requires a management key.