# POST /api/v2/projects/{}/environments/{}/experiments/{}/iterations is deprecated

LaunchDarkly API deprecated POST /api/v2/projects/{}/environments/{}/experiments/{}/iterations without giving a shutdown date yet.

The POST /api/v2/projects/{}/environments/{}/experiments/{}/iterations endpoint has been deprecated without a shutdown date. The provider states that this endpoint will be removed in a future version. Calls made to this route after its eventual removal will fail.

## What to use instead

Use PATCH /api/v2/projects/{projectKey}/environments/{environmentKey}/experiments/{experimentKey} instead, supplying the updateExperimentFields and saveAndStartNewIteration instructions.

- API: LaunchDarkly API (app.launchdarkly.com)
- Kind: Endpoint removal
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `POST /api/v2/projects/{}/environments/{}/experiments/{}/iterations`
- Source: [Announcement](https://app.launchdarkly.com/api/v2/openapi.json)
- Verified: October 26, 2026, against LaunchDarkly API's own pages
- Page: https://www.okapi.bot/providers/launchdarkly-api/breaking-changes/post-api-v2-projects-environments-experiments-iterations-is-deprecated/

## LaunchDarkly API's words

> This endpoint will be removed in a future version. Use the `updateExperimentFields` and `saveAndStartNewIteration` instructions on [Update experiment](https://launchdarkly.com/docs/api/experiments/patch-experiment) instead.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent