Featureflip

Featureflip Feature Flags API

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).

GitHub OpenAPI
Business capability
Feature Flag Management BC-4210.50

Operations 22

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 #

Documentation

📖
APIReference
https://featureflip.io/docs/management-api/reference/
📖
Documentation
https://featureflip.io/docs/management-api/reference/
📖
Documentation
https://featureflip.io/docs/management-api/authentication/
📖
APIReference
https://featureflip.io/docs/api/reference/
📖
Documentation
https://featureflip.io/docs/api/reference/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/featureflip/refs/heads/main/openapi/featureflip-feature-flags-api-openapi.yml

Other Resources

🔗
LLMsTxt
https://featureflip.io/llms.txt

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/featureflip:featureflip-feature-flags-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

featureflip-feature-flags-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Management Feature Flags API
  description: 'Programmatic access to Featureflip — projects, environments, feature flags, variations, targeting, segments, and SDK keys. Authenticate with a Personal Access Token or Service Token via the Authorization: Bearer header.'
  version: v1
servers:
- url: https://api.featureflip.io
  description: Production
security:
- Bearer: []
tags:


# --- truncated at 32 KB (114 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/featureflip/refs/heads/main/openapi/featureflip-feature-flags-api-openapi.yml