# Featureflip Environments API

**Canonical:** https://apis.io/apis/featureflip/featureflip-environments-api/  
**Provider:** Featureflip — https://apis.io/providers/featureflip/  
**Base URL:** https://api.featureflip.io  
**Documentation:** https://featureflip.io/docs/management-api/overview/

Featureflip Environments API is one of 10 APIs that [Featureflip](https://apis.io/providers/featureflip/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Environment. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

Environments within a resolved organization + project — one level deeper than ProjectsController. Every route here carries `{org}`, so ResolveTenantFilter has already resolved + access-checked it before any action runs. `{project}` is resolved key-or-guid, scoped to the resolved org, via ResolveProjectIdAsync for every action (list needs it too, unlike ProjectsController's org-only list). `{env}` (get/update/delete) is then resolved key-or-guid, scoped to the resolved project, via ResolveEnvironmentIdAsync. Dispatched commands/queries always use the resolved GUIDs, never the raw route strings. Writes (create/update/delete) require at least Member (RequireRole); a Viewer attempting one gets a 403 `forbidden` envelope. Deleting a project's last environment surfaces the existing `LAST_ENVIRONMENT` guard (DeleteEnvironmentCommandHandler) as-is — it throws the custom ValidationException, which PublicApiExceptionFilterAttribute maps to a 400 `validation_failed` envelope automatically, so Delete doesn't special-case it. ListEnvironmentsQuery has no `Skip`/`Take` (unlike `ListProjectsQuery`) — a project's environment count is small, so List fetches the full set and paginates in-memory to still expose the standard cursor contract.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/orgs/{org}/projects/{project}/environments` | Creates an environment in the resolved project |
| GET | `/api/v1/orgs/{org}/projects/{project}/environments` | Lists environments in the resolved project, cursor-paginated |
| GET | `/api/v1/orgs/{org}/projects/{project}/environments/{env}` | Gets an environment in the resolved project by key or id |
| PUT | `/api/v1/orgs/{org}/projects/{project}/environments/{env}` | Updates an environment's name/color/sort order |
| DELETE | `/api/v1/orgs/{org}/projects/{project}/environments/{env}` | Deletes an environment |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/featureflip/refs/heads/main/openapi/featureflip-environments-api-openapi.yml
- **APIReference** — https://featureflip.io/docs/management-api/reference/
- **Documentation** — https://featureflip.io/docs/management-api/reference/
- **Documentation** — https://featureflip.io/docs/management-api/authentication/
- **LLMsTxt** — https://featureflip.io/llms.txt
- **APIReference** — https://featureflip.io/docs/api/reference/
- **Documentation** — https://featureflip.io/docs/api/reference/

## Other Featureflip APIs (9)

- [MCP Server (local)](https://apis.io/apis/featureflip/mcp-server-local/)
- [Featureflip Client SDK API](https://apis.io/apis/featureflip/featureflip-client-sdk-api/)
- [Featureflip Feature Flags API](https://apis.io/apis/featureflip/featureflip-feature-flags-api/)
- [Featureflip Me API](https://apis.io/apis/featureflip/featureflip-me-api/)
- [Featureflip Organizations API](https://apis.io/apis/featureflip/featureflip-organizations-api/)
- [Featureflip Projects API](https://apis.io/apis/featureflip/featureflip-projects-api/)
- [Featureflip SDK Keys API](https://apis.io/apis/featureflip/featureflip-sdk-keys-api/)
- [Featureflip Server SDK API](https://apis.io/apis/featureflip/featureflip-server-sdk-api/)
- [Featureflip User Segments API](https://apis.io/apis/featureflip/featureflip-user-segments-api/)

## Tags

Environment

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/featureflip/featureflip-environments-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/featureflip/.