List environments
Returns every environment in the workspace, in workspace order (ascending position).
Requires a management 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.
OK
application/json- response
[index: integer]?A deployment stage in a workspace, such as development or production. Each environment has its own flag values, enabled states, and targeting rules. Every API key belongs to one environment.
curl -X GET 'https://api.toggld.io/api/v1/environments'[ { "id": "env_3f6b2a9c-1d4e-4f7a-8b2c-5e9d0a1f3c7b", "tenantId": "t_5b9e2c4a-8f1d-4a7c-b3e6-9d0c2f5a8b1e", "isProduction": true, "position": 1, "color": "red", "key": "production", "name": "Production", "createdAt": "2026-05-01T12:00:00.000Z" }]Update segment members POST
Adds and removes member keys in one request, and returns the updated segment. Adding an existing member or removing a missing one has no effect, so you can safely retry. Use this endpoint to import members in bulk. Requires a management key. Returns `404` if no segment has this key and `422` if the segment would have more than 5,000 members.
Create an environment POST
Creates an environment and its public token. The new environment goes last in the workspace order. Every existing flag gets a copy of its values from the environment before it, but starts off, with no targeting rules. Later changes in that environment do not affect the copy. Requires a management key. Returns `409` if the key is already in use.