# LaunchDarkly Holdouts API

**Canonical:** https://apis.io/apis/launchdarkly/launchdarkly-holdouts-api/  
**Provider:** LaunchDarkly — https://apis.io/providers/launchdarkly/  
**Base URL:** https://app.launchdarkly.com/api/v2  
**Documentation:** https://launchdarkly.com/docs/api/webhooks

LaunchDarkly Holdouts API is one of 68 APIs that [LaunchDarkly](https://apis.io/providers/launchdarkly/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Holdouts. The published artifact set on APIs.io includes an OpenAPI specification.

> ### Available for customers using Experimentation > > Holdouts are available to customers using [Experimentation](https://launchdarkly.com/docs/api/experiments). Holdouts let you exclude a percentage of your audience from your Experimentation program. This enables you to see the overall effect of your experiments on your customer base, and helps determine how effective the experiments you're running are. Using the holdouts API, you can create, update, and end holdouts. To learn more, read [Holdouts](https://launchdarkly.com/docs/home/holdouts).

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v2/projects/{projectKey}/environments/{environmentKey}/holdouts` | Get all holdouts |
| POST | `/api/v2/projects/{projectKey}/environments/{environmentKey}/holdouts` | Create holdout |
| GET | `/api/v2/projects/{projectKey}/environments/{environmentKey}/holdouts/id/{holdoutId}` | Get Holdout by Id |
| GET | `/api/v2/projects/{projectKey}/environments/{environmentKey}/holdouts/{holdoutKey}` | Get holdout |
| PATCH | `/api/v2/projects/{projectKey}/environments/{environmentKey}/holdouts/{holdoutKey}` | Patch holdout |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/launchdarkly/refs/heads/main/openapi/launchdarkly-holdouts-api-openapi.yml

## Other LaunchDarkly APIs (12)

- [LaunchDarkly Webhooks API](https://apis.io/apis/launchdarkly/webhooks-api/)
- [launchdarkly Access Tokens API](https://apis.io/apis/launchdarkly/launchdarkly-access-tokens-api/)
- [launchdarkly Account Members API](https://apis.io/apis/launchdarkly/launchdarkly-account-members-api/)
- [launchdarkly Approvals API](https://apis.io/apis/launchdarkly/launchdarkly-approvals-api/)
- [launchdarkly Audit Log API](https://apis.io/apis/launchdarkly/launchdarkly-audit-log-api/)
- [launchdarkly Client-Side Evaluation API](https://apis.io/apis/launchdarkly/launchdarkly-client-side-evaluation-api/)
- [launchdarkly Client-Side Streaming API](https://apis.io/apis/launchdarkly/launchdarkly-client-side-streaming-api/)
- [launchdarkly Code References API](https://apis.io/apis/launchdarkly/launchdarkly-code-references-api/)
- [launchdarkly Custom Roles API](https://apis.io/apis/launchdarkly/launchdarkly-custom-roles-api/)
- [launchdarkly Environments API](https://apis.io/apis/launchdarkly/launchdarkly-environments-api/)
- [launchdarkly Experiments API](https://apis.io/apis/launchdarkly/launchdarkly-experiments-api/)
- [launchdarkly Feature Flags API](https://apis.io/apis/launchdarkly/launchdarkly-feature-flags-api/)

## Tags

Holdouts

---

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