# Featureflip Feature Flags API

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

Featureflip Feature Flags 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 Feature Flags. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

Feature flags within a resolved organization + project — mirrors EnvironmentsController's resolve-then-dispatch shape one level deeper. `{project}` is resolved key-or-guid, scoped to the resolved org (with the service-token project allowlist forwarded), via ResolveProjectIdAsync for every action. `{flag}` (get/update/archive/restore/delete) is then resolved key-or-guid, scoped to the resolved project, via ResolveFlagIdAsync. Dispatched commands/queries always use the resolved GUIDs, never the raw route strings. Writes (create/update/archive/restore/ delete) require at least Member (RequireRole); a Viewer attempting one gets a 403 `forbidden` envelope. Flag deletion/variation-removal guards (`FLAG_HAS_DEPENDENTS`, plan limits on create, etc.) surface as-is via the existing handlers' custom ValidationException, which PublicApiExceptionFilterAttribute maps to a 400 `validation_failed` envelope automatically — no action here special-cases them. Defers flag *runtime config* (env-config, toggle, targeting rules, prerequisites) and variations to their own controllers (phase 3b Task 3 / phase 3c).

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/orgs/{org}/projects/{project}/flags` | Creates a feature flag in the resolved project |
| GET | `/api/v1/orgs/{org}/projects/{project}/flags` | Lists feature flags in the resolved project, cursor-paginated |
| GET | `/api/v1/orgs/{org}/projects/{project}/flags/removal-candidates` | Lists confidently-dead (or, with `staleness=stale`, stale-or-dead) flags the… |
| GET | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}` | Gets a feature flag in the resolved project by key or id |
| PUT | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}` | Updates a flag's name/description/tags/client-side visibility |
| DELETE | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}` | Deletes a flag |
| POST | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/archive` | Archives a flag |
| POST | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/restore` | Restores a previously archived flag |
| GET | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/environments` | Gets the resolved flag's config in every environment of the resolved project |
| GET | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/environments/{env}` | Gets the resolved flag's config in a single resolved environment |
| PUT | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/environments/{env}` | Updates the resolved flag's default variation, strategy, and (optionally)… |
| POST | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/environments/{env}/toggle` | Enables or disables the resolved flag in a resolved environment |
| GET | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/environments/{env}/targeting` | Gets the resolved flag's full targeting configuration (enabled flag + ordered… |
| PUT | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/environments/{env}/targeting` | Declaratively replaces the resolved flag's entire targeting rule set in the… |
| POST | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/environments/{env}/rules` | Creates a targeting rule on the resolved flag in the resolved environment |
| GET | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/environments/{env}/rules/{ruleId}` | Gets a single targeting rule on the resolved flag in the resolved environment… |
| PUT | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/environments/{env}/rules/{ruleId}` | Updates a targeting rule's variation/description/rollout/segment/conditions… |
| DELETE | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/environments/{env}/rules/{ruleId}` | Deletes a targeting rule from the resolved flag in the resolved environment |
| PUT | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/environments/{env}/rules/reorder` | Reorders the resolved flag's targeting rules in the resolved environment by… |
| POST | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/variations` | Adds a variation to the resolved flag |
| PUT | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/variations/{variationId}` | Updates a variation's name/value/description |
| DELETE | `/api/v1/orgs/{org}/projects/{project}/flags/{flag}/variations/{variationId}` | Removes a variation from the resolved flag |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/featureflip/refs/heads/main/openapi/featureflip-feature-flags-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 Environments API](https://apis.io/apis/featureflip/featureflip-environments-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

Feature Flags

---

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