LaunchDarkly REST API

The LaunchDarkly REST API lets you build custom integrations, automate your workflow, and manage your feature flags and other LaunchDarkly resources programmatically.

The LaunchDarkly REST API lets you build custom integrations, automate your workflow, and manage your feature flags and other LaunchDarkly resources programmatically.

Base URL

All API requests use the following base URL:

https://app.launchdarkly.com/api/v2

Authentication

All REST API resources are authenticated with either personal or service access tokens, or session cookies. Other authentication mechanisms are not supported. You can manage personal access tokens on your Authorization page in the LaunchDarkly UI.

LaunchDarkly also has SDK keys, mobile keys, and client-side IDs that are used by the SDKs to authenticate to LaunchDarkly. These are not used for the REST API.

Versioning

REST API resources are versioned via a header. Set the LD-API-Version header to the desired API version. If you don’t set this header, the API uses the latest version.

Rate limiting

The REST API applies rate limits on a per-access-token basis. The limit is 403 requests per access token per ten seconds.

Representations

All resources expect and return JSON response bodies. Error responses also send a JSON body.

Feature Flags

Create, update, and manage feature flags

Environments

Manage environments within projects

Projects

Configure and manage projects

Segments

Create and manage user segments

Access Tokens

Manage API access tokens

Experiments

Create and manage experiments

Open

API specification

The raw OpenAPI specification for the LaunchDarkly REST API is available in the following formats:

• OpenAPI JSON
• OpenAPI YAML