# Featureflip SDK Keys API

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

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

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.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| 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 |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/featureflip/refs/heads/main/openapi/featureflip-sdk-keys-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 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 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

SDK Keys

---

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