Delete an environment
Permanently deletes an environment, with its flag configuration, API keys, and public token. Requests that use those credentials then fail with 401.
Requires a management key.
Returns 404 if the environment does not exist. Returns 409 if it is the only environment in the workspace.
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.
environmentId*stringThe environment ID, such as env_….
No content
curl -X DELETE 'https://api.toggld.io/api/v1/environments/string'Update an environment PATCH
Changes the key, name, color, or production setting of an environment. Omitted fields keep their current values. To change the order of environments, use the reorder environments endpoint. Requires a management key. Returns `404` if the environment does not exist and `409` if the new key is already in use.
List API keys GET
Returns every secret API key in the workspace, in all environments. The response never includes the tokens, only a short prefix of each. Requires a management key.