Workflows (beta)

Workflows is an add-on feature

Workflows is available to customers on an Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.

A workflow is a set of actions that you can schedule in advance to make changes to a feature flag at a future date and time. You can also include approval requests at different stages of a workflow. To learn more, read Workflows.

The actions supported are as follows:

Turning targeting ON or OFF
Setting the default variation
Creating a rule to target a group of users by segment
Modifying the rollout percentage for rules

You can create multiple stages of a flag release workflow. Unique stages are defined by their conditions: either approvals and/or scheduled changes.

Get workflows

Display workflows associated with a feature flag.

SecurityApiKey

Request

path Parameters

projectKey required	string <string> The project key
featureFlagKey required	string <string> The feature flag key
environmentKey required	string <string> The environment key

Responses

200

401

Invalid access token

403

Forbidden

404

Invalid resource identifier

429

Rate limited

get/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/workflows

Request samples

curl
Node.js
Python

curl -i -X GET \
  'https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/workflows' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/json

{"items": [{"_id": "string",
"_version": 0,
"_conflicts": [{"stageId": "string",
"message": "string"
}
],
"_creationDate": 0,
"_maintainerId": "string",
"_links": {"property1": {"href": "string",
"type": "string"
},
"property2": {"href": "string",
"type": "string"
}
},
"name": "string",
"description": "string",
"kind": "string",
"stages": [{"_id": "string",
"name": "string",
"conditions": [{"_id": "string",
"kind": "string",
"_execution": {"status": null
},
"scheduleKind": "string",
"executionDate": 0,
"waitDuration": 0,
"waitDurationUnit": "string",
"description": "string",
"notifyMemberIds": [null
],
"allReviews": [null
],
"reviewStatus": "string",
"appliedDate": 0
}
],
"action": {"kind": "string",
"instructions": [{"property1": null,
"property2": null
}
]
},
"_execution": {"status": "string"
}
}
],
"_execution": {"status": "string"
}
}
]
}

Create workflow

Create a workflow for a feature flag.

SecurityApiKey

Request

path Parameters

projectKey required	string <string> The project key
featureFlagKey required	string <string> The feature flag key
environmentKey required	string <string> The environment key

Request Body schema: application/json

maintainerId	string (ObjectId)
name	string
description required	string
	Array of objects (StageInputRep)

Responses

201

Successful workflow response

400

Invalid request

401

Invalid access token

403

Forbidden

404

Invalid resource identifier

429

Rate limited

post/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/workflows

Request samples

Payload
curl
Node.js
Python

application/json

{"maintainerId": "string",
"name": "string",
"description": "string",
"stages": [{"name": "string",
"executeConditionsInSequence": true,
"conditions": [{"scheduleKind": "string",
"executionDate": 0,
"waitDuration": 0,
"waitDurationUnit": "string",
"executeNow": true,
"description": "string",
"notifyMemberIds": ["string"
],
"kind": "string"
}
],
"action": {"instructions": null
}
}
]
}

Response samples

application/json

{"_id": "string",
"_version": 0,
"_conflicts": [{"stageId": "string",
"message": "string"
}
],
"_creationDate": 0,
"_maintainerId": "string",
"_links": {"property1": {"href": "string",
"type": "string"
},
"property2": {"href": "string",
"type": "string"
}
},
"name": "string",
"description": "string",
"kind": "string",
"stages": [{"_id": "string",
"name": "string",
"conditions": [{"_id": "string",
"kind": "string",
"_execution": {"status": "string"
},
"scheduleKind": "string",
"executionDate": 0,
"waitDuration": 0,
"waitDurationUnit": "string",
"description": "string",
"notifyMemberIds": ["string"
],
"allReviews": [{"_id": "string",
"kind": "string",
"creationDate": 0,
"comment": "string",
"memberId": "string"
}
],
"reviewStatus": "string",
"appliedDate": 0
}
],
"action": {"kind": "string",
"instructions": [{"property1": null,
"property2": null
}
]
},
"_execution": {"status": "string"
}
}
],
"_execution": {"status": "string"
}
}

Get custom workflow

Get a specific workflow by ID.

SecurityApiKey

Request

path Parameters

projectKey required	string <string> The project key
featureFlagKey required	string <string> The feature flag key
environmentKey required	string <string> The environment key
workflowId required	string <string> The workflow ID

Responses

200

401

Invalid access token

403

Forbidden

404

Invalid resource identifier

429

Rate limited

get/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/workflows/{workflowId}

Request samples

curl
Node.js
Python

curl -i -X GET \
  'https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/workflows/{workflowId}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/json

{"_id": "string",
"_version": 0,
"_conflicts": [{"stageId": "string",
"message": "string"
}
],
"_creationDate": 0,
"_maintainerId": "string",
"_links": {"property1": {"href": "string",
"type": "string"
},
"property2": {"href": "string",
"type": "string"
}
},
"name": "string",
"description": "string",
"kind": "string",
"stages": [{"_id": "string",
"name": "string",
"conditions": [{"_id": "string",
"kind": "string",
"_execution": {"status": "string"
},
"scheduleKind": "string",
"executionDate": 0,
"waitDuration": 0,
"waitDurationUnit": "string",
"description": "string",
"notifyMemberIds": ["string"
],
"allReviews": [{"_id": "string",
"kind": "string",
"creationDate": 0,
"comment": "string",
"memberId": "string"
}
],
"reviewStatus": "string",
"appliedDate": 0
}
],
"action": {"kind": "string",
"instructions": [{"property1": null,
"property2": null
}
]
},
"_execution": {"status": "string"
}
}
],
"_execution": {"status": "string"
}
}

Delete workflow

Delete a workflow from a feature flag.

SecurityApiKey

Request

path Parameters

projectKey required	string <string> The project key
featureFlagKey required	string <string> The feature flag key
environmentKey required	string <string> The environment key
workflowId required	string <string> The workflow id

Responses

204

Action completed successfully

400

Invalid request

401

Invalid access token

403

Forbidden

404

Invalid resource identifier

429

Rate limited

delete/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/workflows/{workflowId}

Request samples

curl
Node.js
Python

curl -i -X DELETE \
  'https://app.launchdarkly.com/api/v2/projects/{projectKey}/flags/{featureFlagKey}/environments/{environmentKey}/workflows/{workflowId}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Response samples

application/json

{"code": "invalid_request",
"message": "invalid request body"
}

➔ Next to Other