---
title: "Create scheduled changes workflow"
method: POST
path: "/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/scheduled-changes"
tags: ["Scheduled changes"]
---

# Create scheduled changes workflow

`POST /api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/scheduled-changes`

Create scheduled changes for a feature flag. The changes you schedule may include any semantic patch instructions available when [updating a feature flag](https://launchdarkly.com/docs/api/feature-flags/patch-feature-flag#using-semantic-patches-on-a-feature-flag). If the `ignoreConflicts` query parameter is false and there are conflicts between these instructions and existing scheduled changes, the request will fail. If the parameter is true and there are conflicts, the request will succeed.

## Path parameters

- `projectKey` string, string, required — The project key
- `featureFlagKey` string, string, required — The feature flag key
- `environmentKey` string, string, required — The environment key

## Query parameters

- `ignoreConflicts` boolean — Whether to succeed (`true`) or fail (`false`) when these instructions conflict with existing scheduled changes

## Request body

- PostFlagScheduledChangesInput
  - `comment` string — Optional comment describing the scheduled changes
  - `executionDate` integer, required
  - `instructions` Instruction[], required

## Response `201`

Scheduled changes response

- FeatureFlagScheduledChange
  - `_id` string, required
  - `_creationDate` integer, required
  - `_maintainerId` string, required — The ID of the scheduled change maintainer
  - `_version` integer, required — Version of the scheduled change
  - `executionDate` integer, required
  - `instructions` Instruction[], required
  - `conflicts` unknown
  - `_links` object — The location and content type of related resources

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `403` — Forbidden
- `404` — Invalid resource identifier
- `405` — Method not allowed
- `409` — Status conflict
- `429` — Rate limited

---

[API](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/revisions/69c5c9aafe78/schema)