Management API
Environments
List, create, update and archive environments, and read an environment summary.
Environments are where flags are configured and where SDK keys and snapshots live. Admins create, rename and archive them; turning off an environment’s confirm requirement needs an owner.
Keys of an archived environment stop working on delivery.
Operations
| Operation | Request | Who may call it |
|---|---|---|
| listEnvironments | GET /api/orgs/{org}/projects/{project}/environments | viewer or above |
| createEnvironment | POST /api/orgs/{org}/projects/{project}/environments | admin or above |
| updateEnvironment | PATCH /api/orgs/{org}/projects/{project}/environments/{env} | admin or above; owner to turn off requireConfirm |
| archiveEnvironment | POST /api/orgs/{org}/projects/{project}/environments/{env}/archive | admin or above |
| getEnvironmentSummary | GET /api/orgs/{org}/projects/{project}/environments/{env}/summary | viewer or above |
Management API requests carry a user token and are checked against the caller’s organization role. Delivery API requests carry an SDK key; the two never cross. Errors are always { error: { code, message } }.