How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

launchdarkly Feature Flags API

Create, update, and manage feature flags and their targeting rules across projects and environments.

launchdarkly Feature Flags API is one of 68 APIs that LaunchDarkly publishes on the 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 and API documentation.

This API exposes 19 operations across 11 paths, and defines 95 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 3 base URLs: https://app.launchdarkly.com, https://app.launchdarkly.us, https://app.launchdarkly.com/api/v2.

19 operations 11 paths 95 schemas 2 DELETE9 GET4 PATCH4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://app.launchdarkly.com/api/v2
Authentication
API Key, HTTP Bearer
License
Resource Areas
1

Authentication & Security 2

launchdarkly Feature Flags API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (ApiKey). It accepts HTTP bearer tokens (bearerAuth).

  • bearerAuth — LaunchDarkly API access token. Create personal or service tokens in the LaunchDarkly dashboard under Account Settings.

Paths & Operations 19

Across 11 paths, the API surfaces 19 operations — 2 DELETE, 9 GET, 4 PATCH, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Feature Flags 19

The feature flags API allows you to list, create, and modify feature flags and their targeting. For example, you can control percentage rollouts, target specific contexts, or even…

GET
/api/v2/flag-status/{projectKey}/{featureFlagKey}
Get flag status across environments
getFeatureFlagStatusAcrossEnvironments 3 params → 200401403404429
GET
/api/v2/flag-statuses/{projectKey}/{environmentKey}
List feature flag statuses
getFeatureFlagStatuses 2 params → 200401403404429
GET
/api/v2/flag-statuses/{projectKey}/{environmentKey}/{featureFlagKey}
Get feature flag status
getFeatureFlagStatus 3 params → 200401403404429
GET
/api/v2/flags/{projectKey}
List feature flags
getFeatureFlags 11 params → 200400401403404429
POST
/api/v2/flags/{projectKey}
Create a feature flag
postFeatureFlag 2 params body → 201400401409429
GET
/api/v2/flags/{projectKey}/{featureFlagKey}
Get feature flag
getFeatureFlag 4 params → 200401403404429
PATCH
/api/v2/flags/{projectKey}/{featureFlagKey}
Update feature flag
patchFeatureFlag 4 params body → 200400401404405409429
DELETE
/api/v2/flags/{projectKey}/{featureFlagKey}
Delete feature flag
deleteFeatureFlag 2 params → 204401404409429
POST
/api/v2/flags/{projectKey}/{featureFlagKey}/copy
Copy feature flag
copyFeatureFlag 2 params body → 201400401405409429
GET
/api/v2/flags/{projectKey}/{featureFlagKey}/expiring-targets/{environmentKey}
Get expiring context targets for feature flag
getExpiringContextTargets 3 params → 200401403404429
PATCH
/api/v2/flags/{projectKey}/{featureFlagKey}/expiring-targets/{environmentKey}
Update expiring context targets on feature flag
patchExpiringTargets 3 params body → 200400401403404429
GET
/api/v2/flags/{projectKey}/{featureFlagKey}/expiring-user-targets/{environmentKey}
Get expiring user targets for feature flag
getExpiringUserTargets 3 params → 200401403404429
PATCH
/api/v2/flags/{projectKey}/{featureFlagKey}/expiring-user-targets/{environmentKey}
Update expiring user targets on feature flag
patchExpiringUserTargets 3 params body → 200400401403404429
POST
/api/v2/projects/{projectKey}/flags/{flagKey}/environments/{environmentKey}/migration-safety-issues
Get migration safety issues
postMigrationSafetyIssues 3 params body → 200204400401403404429503
GET
/flags/{projectKey}
List feature flags
listFeatureFlags 6 params → 200401404
POST
/flags/{projectKey}
Create a feature flag
createFeatureFlag 1 param body → 201400401409
GET
/flags/{projectKey}/{flagKey}
Get a feature flag
getFlagsByProjectKeyByFlagKey 3 params → 200401404
PATCH
/flags/{projectKey}/{flagKey}
Update a feature flag
patchFlagsByProjectKeyByFlagKey 2 params body → 200400401404409
DELETE
/flags/{projectKey}/{flagKey}
Delete a feature flag
deleteFlagsByProjectKeyByFlagKey 2 params → 204401404

Schemas 95

The contract defines 95 schemas that model the data the API accepts and returns. The most detailed are MetricListingRep (47 properties), FeatureFlag (28 properties), FeatureFlagConfig (21 properties), FeatureFlagBody (16 properties). Each schema is shown below with its type and property counts.

FeatureFlag
object
28 properties 12 required
Variation
object
5 properties 1 required
MemberSummary
object
6 properties 4 required
Operator
string
ForbiddenErrorRep
object
2 properties 2 required
Clause
object
6 properties 4 required
LegacyExperimentRep
object
4 properties
ResourceKind
string
ActionIdentifier
string
FeatureFlagStatusAcrossEnvironments
object
3 properties 3 required
WeightedVariation
object
3 properties 2 required
FlagCopyConfigEnvironment
object
2 properties 1 required
ClientSideAvailabilityPost
object
2 properties 2 required
FeatureFlagBody
object
16 properties 2 required
Access
object
2 properties 2 required
ExpiringTargetGetResponse
object
2 properties 1 required
AccessAllowedRep
object
2 properties 2 required
FlagPrerequisitePost
object
2 properties 2 required
CustomProperties
object
ExpiringUserTargetPatchResponse
object
6 properties 1 required
Modification
object
1 property
StatusServiceUnavailable
object
2 properties 2 required
FeatureFlagStatuses
object
2 properties 1 required
RateLimitedErrorRep
object
2 properties 2 required
MigrationFlagStageCount
integer
UnauthorizedErrorRep
object
2 properties 2 required
ActionSpecifier
string
ExpiringUserTargetGetResponse
object
2 properties 1 required
flagSempatch
object
2 properties 1 required
MethodNotAllowedErrorRep
object
2 properties 2 required
StaleFlagData
object
3 properties
MigrationSafetyIssueRep
object
4 properties
FeatureFlags
object
4 properties 2 required
NotFoundErrorRep
object
2 properties 2 required
Defaults
object
2 properties 2 required
ExperimentEnabledPeriodRep
object
2 properties
AccessAllowedReason
object
6 properties 1 required
ResourceIDResponse
object
5 properties
Prerequisite
object
2 properties 2 required
FeatureFlagStatus
object
3 properties 1 required
FlagConfigEvaluation
object
1 property
VariationOrRolloutRep
object
2 properties
MaintainerTeam
object
3 properties 2 required
ExperimentEnvironmentSettingRep
object
3 properties
JSONPatch
array
UrlMatcher
object
Instructions
array
InvalidRequestErrorRep
object
2 properties 2 required
MetricDenominatorRep
object
12 properties
MigrationSettingsPost
object
2 properties 1 required
UrlMatchers
array
ExperimentInfoRep
object
2 properties 2 required
MetricListingRep
object
47 properties 9 required
ExpiringTargetPatchResponse
object
6 properties 1 required
Target
object
3 properties 2 required
ClientSideAvailability
object
2 properties
FlagCopyConfigPost
object
5 properties 2 required
VariationSummary
object
8 properties 4 required
StatusConflictErrorRep
object
2 properties 2 required
FlagMigrationSettingsRep
object
2 properties
patchFlagsRequest
object
2 properties 1 required
PatchWithComment
object
2 properties 1 required
ExperimentAllocationRep
object
2 properties 2 required
ResourceId
object
5 properties
MetricDataSourceRefRep
object
4 properties 1 required
FlagSummary
object
2 properties 2 required
Rollout
object
5 properties 1 required
AccessDenied
object
2 properties 2 required
AccessDeniedReason
object
6 properties 1 required
customProperty
object
2 properties 2 required
MetricEventDefaultRep
object
2 properties
Link
object
2 properties
Filter
object
6 properties 4 required
UnixMillis
integer
PatchOperation
object
3 properties 2 required
ExpiringTargetError
object
2 properties 2 required
ExpiringUserTargetItem
object
7 properties 5 required
FlagStatusRep
object
4 properties 2 required
Rule
object
8 properties 2 required
AllVariationsSummary
object
Instruction
object
FeatureFlagConfig
object
21 properties 10 required
FlagConfigMigrationSettingsRep
object
1 property
ExpiringTarget
object
8 properties 6 required
FeatureFlag_2
object
A feature flag with its configuration across all environments.
12 properties
Rollout_2
object
A percentage rollout configuration.
3 properties
Target_2
object
An individual targeting entry for a specific variation.
3 properties
FeatureFlagBody_2
object
The request body for creating a new feature flag.
8 properties 2 required
Variation_2
object
A single variation value that a feature flag can serve.
4 properties
Links
object
HATEOAS links for navigating related resources.
1 property
FlagEnvironment
object
The configuration of a feature flag for a specific environment.
10 properties
FeatureFlags_2
object
A paginated collection of feature flags.
3 properties
Rule_2
object
A targeting rule with clauses and a variation or rollout.
5 properties
PatchOperation_2
object
A JSON Patch or semantic patch request.
2 properties
Clause_2
object
A condition clause used in targeting rules.
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

launchdarkly-feature-flags-api-openapi.yml Raw ↑

Other APIs LaunchDarkly publishes across the network.

LaunchDarkly Webhooks API
launchdarkly Access Tokens API
launchdarkly Account Members API
launchdarkly Approvals API
launchdarkly Audit Log API
launchdarkly Client-Side Evaluation API
launchdarkly Client-Side Streaming API
launchdarkly Code References API
launchdarkly Custom Roles API
launchdarkly Environments API
launchdarkly Experiments API
launchdarkly Flag Triggers API
Where this information came from

This is an independent, third-party profile of launchdarkly Feature Flags API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.