Featureflip SDK Keys API

SDK keys within a resolved organization + project + environment — one level deeper than EnvironmentsController. Every action resolves `{project}` (key-or-guid, scoped to the resolved org, with the service-token project allowlist forwarded) then `{env}` (key-or-guid, scoped to the resolved project) via IPublicApiTenantResolver, mirroring FeatureFlagsController's resolve-then-dispatch shape. Unlike `{project}`/`{env}`, `{sdkKey}` is guid-only — SDK keys have no key/slug of their own — resolved via ResolveSdkKeyIdAsync, which throws the same not-found error for a non-guid segment as a genuinely missing key. Writes (create/update/revoke) require at least Member (RequireRole); a Viewer attempting one gets a 403 `forbidden` envelope. Type is a bare string on the wire; Create parses it to SdkKeyType against a NAME allowlist (`Enum.TryParse` + `Enum.GetNames().Contains(...)`) rather than a bare `Enum.TryParse`/`Enum.IsDefined` pair — the latter would silently accept a numeric string (e.g. `"0"`) and resolve it to the first enum member. An unrecognized value throws the custom ValidationException BEFORE the environment is resolved or any command is dispatched, mapped to a 400 `validation_failed` envelope by PublicApiExceptionFilterAttribute — same pattern as MapConditions's operator parse. The plaintext key returned by CreateSdkKeyResult is a one-time value — it is never recoverable afterward, so unlike Create's re-fetch-after-write pattern, Create builds its response directly from the command result rather than dispatching a follow-up query. List and Get return PublicSdkKeyResponse, which carries only `LastFourCharacters` — never the plaintext.

GitHub OpenAPI

Operations 5

POST /api/v1/orgs/{org}/projects/{project}/environments/{env}/sdk-keys Creates an SDK key in the resolved environment #
GET /api/v1/orgs/{org}/projects/{project}/environments/{env}/sdk-keys Lists SDK keys in the resolved environment, cursor-paginated #
GET /api/v1/orgs/{org}/projects/{project}/environments/{env}/sdk-keys/{sdkKey} Gets an SDK key in the resolved environment by id (guid-only — see the… #
PUT /api/v1/orgs/{org}/projects/{project}/environments/{env}/sdk-keys/{sdkKey} Updates an SDK key's name/description #
POST /api/v1/orgs/{org}/projects/{project}/environments/{env}/sdk-keys/{sdkKey}/revoke Revokes an SDK key #

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-sdk-keys-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

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

OpenAPI Specification

featureflip-sdk-keys-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Management SDK Keys 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 (32 KB total) ---
# Full source: https://artifacts.apis.io/featureflip/openapi/featureflip-sdk-keys-api-openapi.yml