Create scheduled changes workflow | LaunchDarkly

1 import requests 2 3 url = "https://app.launchdarkly.com/api/v2/projects/projectKey/flags/featureFlagKey/environments/environmentKey/scheduled-changes" 4 5 payload = { 6 "executionDate": 1718467200000, 7 "instructions": [{ "kind": "turnFlagOn" }], 8 "comment": "Optional comment describing the scheduled changes" 9 } 10 headers = { 11 "Authorization": "<apiKey>", 12 "Content-Type": "application/json" 13 } 14 15 response = requests.post(url, json=payload, headers=headers) 16 17 print(response.json())

1 { 2 "_id": "_id", 3 "_creationDate": 1000000, 4 "_maintainerId": "12ab3c45de678910abc12345", 5 "_version": 1, 6 "executionDate": 1000000, 7 "instructions": [ 8 { 9 "key": "value" 10 } 11 ], 12 "conflicts": { 13 "key": "value" 14 }, 15 "_links": { 16 "key": { 17 "href": "href", 18 "type": "type" 19 } 20 } 21 }

Create scheduled changes for a feature flag. The changes you schedule may include any semantic patch instructions available when updating a feature flag. If the ignoreConficts 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.

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 `ignoreConficts` 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.

Authentication

Authorizationstring

API Key authentication via header

Path parameters

projectKeystringRequired

The project key

featureFlagKeystringRequired

The feature flag key

environmentKeystringRequired

The environment key

Query parameters

ignoreConflictsbooleanOptional

Whether to succeed (true) or fail (false) when these instructions conflict with existing scheduled changes

Request

This endpoint expects an object.

executionDatelongRequired

When the scheduled changes should be executed

instructionslist of maps from strings to anyRequired

The actions to perform on the execution date for these scheduled changes. This should be an array with a single object that looks like <code>{“kind”: “scheduled_action”}</code>. Supported scheduled actions include any semantic patch instructions available when updating a feature flag.

commentstringOptional

Optional comment describing the scheduled changes

Response

Scheduled changes response

_idstring

The ID of this scheduled change

_creationDatelong

Timestamp of when the scheduled change was created

_maintainerIdstring

The ID of the scheduled change maintainer

_versioninteger

Version of the scheduled change

executionDatelong

When the scheduled changes should be executed

instructionslist of maps from strings to any

The actions to perform on the execution date for these scheduled changes

conflictsany or null

_linksmap from strings to objects or null

The location and content type of related resources

Authentication

Path parameters

Query parameters

Request

Response

Errors