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 Approvals API

Manage approval requests and workflows for flag changes that require review before deployment.

launchdarkly Approvals API is one of 68 APIs that LaunchDarkly publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Approvals. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 15 operations across 10 paths, and defines 64 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.

15 operations 10 paths 64 schemas 2 DELETE5 GET8 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 Approvals 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 15

Across 10 paths, the API surfaces 15 operations — 2 DELETE, 5 GET, 8 POST. Each is listed below with its method, path, parameters, and response codes.

Approvals 15

An account member can request approval on changes to a flag or AgentControl config's targeting or variations, or to a segment's targeting. Members may be required to request appro…

GET
/api/v2/approval-requests
List approval requests
getApprovalRequests 4 params → 200400401403429
POST
/api/v2/approval-requests
Create approval request
postApprovalRequest body → 201400401403429
GET
/api/v2/approval-requests/{id}
Get approval request
getApprovalRequest 2 params → 200400401403404429
DELETE
/api/v2/approval-requests/{id}
Delete approval request
deleteApprovalRequest 1 param → 204401403404429
POST
/api/v2/approval-requests/{id}/apply
Apply approval request
postApprovalRequestApply 1 param body → 200400401403404429
POST
/api/v2/approval-requests/{id}/reviews
Review approval request
postApprovalRequestReview 1 param body → 200400401404405409429
GET
/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests
List approval requests for a flag
getApprovalsForFlag 3 params → 200401403404429
POST
/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests
Create approval request for a flag
postApprovalRequestForFlag 3 params body → 201400401403429
POST
/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests-flag-copy
Create approval request to copy flag configurations across environments
postFlagCopyConfigApprovalRequest 3 params body → 201400401403409429
GET
/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests/{id}
Get approval request for a flag
getApprovalForFlag 4 params → 200401403404429
DELETE
/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests/{id}
Delete approval request for a flag
deleteApprovalRequestForFlag 4 params → 204401403404429
POST
/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests/{id}/apply
Apply approval request for a flag
postApprovalRequestApplyForFlag 4 params body → 200400401403404429
POST
/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/approval-requests/{id}/reviews
Review approval request for a flag
postApprovalRequestReviewForFlag 4 params body → 200400401403404429
GET
/flags/{projectKey}/{flagKey}/approval-requests/{environmentKey}
List approval requests for a flag
listApprovalRequests 3 params → 200401404
POST
/flags/{projectKey}/{flagKey}/approval-requests/{environmentKey}
Create an approval request
createApprovalRequest 3 params body → 201400401

Schemas 64

The contract defines 64 schemas that model the data the API accepts and returns. The most detailed are ExpandableApprovalRequestResponse (28 properties), ApprovalRequestResponse (24 properties), UserSegment (23 properties), FlagConfigApprovalRequestResponse (22 properties). Each schema is shown below with its type and property counts.

CustomProperties
object
Environment
object
17 properties 14 required
SegmentMetadata
object
7 properties
FormVariableConfig
object
AccessDenied
object
2 properties 2 required
postApprovalRequestReviewRequest
object
2 properties
Variation
object
5 properties 1 required
Instructions
array
InvalidRequestErrorRep
object
2 properties 2 required
sourceFlag
object
2 properties 1 required
MemberSummary
object
6 properties 4 required
AccessDeniedReason
object
6 properties 1 required
ExpandableApprovalRequestResponse
object
28 properties 11 required
RateLimitedErrorRep
object
2 properties 2 required
CustomWorkflowMeta
object
2 properties
UnauthorizedErrorRep
object
2 properties 2 required
customProperty
object
2 properties 2 required
ForbiddenErrorRep
object
2 properties 2 required
Operator
string
Clause
object
6 properties 4 required
ActionSpecifier
string
FlagConfigApprovalRequestsResponse
object
2 properties 2 required
ExpandedExperimentRep
object
3 properties 2 required
Link
object
2 properties
ActionIdentifier
string
ClientSideAvailability
object
2 properties
ApprovalSettings
object
10 properties 8 required
Environments
object
3 properties 1 required
UnixMillis
integer
createCopyFlagConfigApprovalRequestRequest
object
7 properties 2 required
FlagListingRep
object
4 properties 2 required
IntegrationStatus
object
2 properties 2 required
ExpandableApprovalRequestsResponse
object
3 properties 3 required
Project
object
10 properties 6 required
UserSegment
object
23 properties 10 required
ExpandedResourceRep
object
5 properties 1 required
MethodNotAllowedErrorRep
object
2 properties 2 required
CreateApprovalRequestRequest
object
7 properties 3 required
UserSegmentRule
object
6 properties 1 required
ApprovalRequestResponse
object
24 properties 11 required
CustomWorkflowStageMeta
object
2 properties
Access
object
2 properties 2 required
StatusConflictErrorRep
object
2 properties 2 required
NotFoundErrorRep
object
2 properties 2 required
Defaults
object
2 properties 2 required
AIConfigRep
object
2 properties 2 required
ExpandedFlagRep
object
18 properties 11 required
SegmentId
string
AccessAllowedReason
object
6 properties 1 required
Instruction
object
AccessAllowedRep
object
2 properties 2 required
Conflict
object
2 properties
ReviewResponse
object
6 properties 2 required
createFlagConfigApprovalRequestRequest
object
8 properties 2 required
FlagConfigApprovalRequestResponse
object
22 properties 11 required
SegmentTarget
object
2 properties
ApprovalRequestServiceKind
string
IntegrationMetadata
object
4 properties 4 required
postApprovalRequestApplyRequest
object
1 property
CopiedFromEnv
object
2 properties 1 required
ApprovalRequests
object
A collection of approval requests.
2 properties
ApprovalRequest
object
An approval request for a pending flag change.
6 properties
Links
object
HATEOAS links for navigating related resources.
1 property
ApprovalRequestBody
object
The request body for creating a new approval request.
4 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

launchdarkly-approvals-api-openapi.yml Raw ↑

Other APIs LaunchDarkly publishes across the network.

LaunchDarkly Webhooks API
launchdarkly Access Tokens API
launchdarkly Account Members 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 Feature Flags API
launchdarkly Flag Triggers API
Where this information came from

This is an independent, third-party profile of launchdarkly Approvals 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.