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

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

The POST /api/v2/projects/{id}/environments/{id}/experiments/{id}/iterations endpoint has been deprecated without a shutdown date. LaunchDarkly API 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/{id}/environments/{id}/experiments/{id}/iterations`
- Source: [Announcement](https://app.launchdarkly.com/api/v2/openapi.json)
- Verified: November 6, 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