v5

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-02-283466592.5 MB
Scheduled changes

Create scheduled changes workflow

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

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

Path parameters

projectKeystring string required

The project key

The project key

featureFlagKeystring string required

The feature flag key

The feature flag key

environmentKeystring string required

The environment key

The environment key

Query parameters

ignoreConflictsboolean

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

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

Request body

commentstring

Optional comment describing the scheduled changes

executionDateinteger required
instructionsInstruction[] required

Example request

{
  "comment": "optional comment"
}

Response

Scheduled changes response

_idstring required
_creationDateinteger required
_maintainerIdstring required

The ID of the scheduled change maintainer

_versioninteger required

Version of the scheduled change

executionDateinteger required
instructionsInstruction[] required
{"stackTrail":"components:schemas:FeatureFlagScheduledChange:properties:conflicts","oasType":"schema","type":"unknown","description":"Details on any conflicting scheduled changes"}
_linksobject

The location and content type of related resources

Example response

{
  "_maintainerId": "12ab3c45de678910abc12345",
  "_version": 1
}