> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/launchdarkly.md).

# LaunchDarkly

Manage LaunchDarkly feature flags and trigger workflows from flag changes.

### Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector    | Authentication   |
| ------------ | ---------------- |
| LaunchDarkly | API access token |

#### LaunchDarkly

Connect to LaunchDarkly feature flags with a personal or service API token.

**Set up in LaunchDarkly**

1. Prepare the LaunchDarkly account or service that the workflow will access. Grant access to the required resources and operations.
2. **API access token:** Use a scoped service token with viewProject and the flag actions needed by your workflow. Triggers also need createWebhook/deleteWebhook. SDK keys do not work.
3. **Region:** Choose the LaunchDarkly instance where this token was created.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **LaunchDarkly**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field    | Required                 | What to enter                                                                                                                                                                                                                                 |
| ---------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API access token | Yes                      | Use a scoped service token with viewProject and the flag actions needed by your workflow. Triggers also need createWebhook/deleteWebhook. SDK keys do not work. [Provider instructions](https://app.launchdarkly.com/settings/authorization). |
| Region           | Optional / as applicable | Choose the LaunchDarkly instance where this token was created.                                                                                                                                                                                |

#### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

### Use an action

1. Add the required **LaunchDarkly** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

### Actions

#### List Feature Flags

List feature flags in a LaunchDarkly project.

**Required permissions:** `viewProject`.

**Inputs**

| Field                  | Type            | Required | Description                                                                                                |
| ---------------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
| Project                | select (string) | Yes      | Project containing the feature flag. Options load from the selected connection.                            |
| Environment            | select (string) | No       | Optionally include targeting configuration for one environment. Options load from the selected connection. |
| Tag                    | string          | No       | Only return flags with this tag.                                                                           |
| Include archived flags | boolean         | No       | Include archived feature flags in the results. Default: false.                                             |
| Maximum flags          | integer         | No       | Maximum feature flags to return. Minimum: 1. Default: 100.                                                 |
| Starting offset        | integer         | No       | Continue from a previous result page. Minimum: 0. Default: 0.                                              |

**Outputs**

| Field         | Type          | Description                                                     |
| ------------- | ------------- | --------------------------------------------------------------- |
| Feature flags | object\_array | Feature flag summaries for the selected project.                |
| Next offset   | integer       | Offset for the next result page, when more flags are available. |

#### Get Feature Flag

Get one feature flag with its variations and per-environment targeting configuration.

**Required permissions:** `viewProject`.

**Inputs**

| Field        | Type            | Required | Description                                                                                                |
| ------------ | --------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
| Project      | select (string) | Yes      | Project containing the feature flag. Options load from the selected connection.                            |
| Environment  | select (string) | No       | Optionally include targeting configuration for one environment. Options load from the selected connection. |
| Feature flag | select (string) | Yes      | Feature flag to operate on. Options load from the selected connection.                                     |

**Outputs**

| Field        | Type   | Description                                          |
| ------------ | ------ | ---------------------------------------------------- |
| Feature flag | object | Feature flag configuration returned by LaunchDarkly. |

#### Create Feature Flag

Create a boolean or multivariate feature flag in a LaunchDarkly project.

**Required permissions:** `createFlag`.

**Inputs**

| Field            | Type            | Required | Description                                                                                  |
| ---------------- | --------------- | -------- | -------------------------------------------------------------------------------------------- |
| Project          | select (string) | Yes      | Project containing the feature flag. Options load from the selected connection.              |
| Flag key         | string          | Yes      | Stable unique key used by application code.                                                  |
| Flag name        | string          | Yes      | Human-readable name shown in LaunchDarkly.                                                   |
| Variation type   | select (string) | Yes      | Value type served by this flag. Available values: Boolean, String, Number. Default: boolean. |
| Variation values | textarea        | No       | Comma-separated values for a string or number flag.                                          |
| Temporary flag   | boolean         | No       | Mark the flag as temporary so it can be tracked for cleanup. Default: true.                  |
| Description      | textarea        | No       | Explain what the flag controls and when it can be removed.                                   |
| Tags             | string          | No       | Comma-separated tags for ownership and discovery.                                            |

**Outputs**

| Field        | Type   | Description                                          |
| ------------ | ------ | ---------------------------------------------------- |
| Feature flag | object | Feature flag configuration returned by LaunchDarkly. |

#### Toggle Flag On

WARNING: This is not a dry run. On success, it turns on the selected feature flag and activates its existing targeting in that environment.

**Required permissions:** `updateOn`.

**Inputs**

| Field         | Type            | Required | Description                                                                             |
| ------------- | --------------- | -------- | --------------------------------------------------------------------------------------- |
| Project       | select (string) | Yes      | Project containing the feature flag. Options load from the selected connection.         |
| Environment   | select (string) | Yes      | Environment for this feature flag operation. Options load from the selected connection. |
| Feature flag  | select (string) | Yes      | Feature flag to operate on. Options load from the selected connection.                  |
| Audit comment | textarea        | No       | Optional reason recorded with the change.                                               |

**Outputs**

| Field        | Type   | Description                                          |
| ------------ | ------ | ---------------------------------------------------- |
| Feature flag | object | Feature flag configuration returned by LaunchDarkly. |

#### Toggle Flag Off

WARNING: This kill switch changes live behavior. It turns targeting off for the selected feature flag in one environment.

**Required permissions:** `updateOn`.

**Inputs**

| Field         | Type            | Required | Description                                                                             |
| ------------- | --------------- | -------- | --------------------------------------------------------------------------------------- |
| Project       | select (string) | Yes      | Project containing the feature flag. Options load from the selected connection.         |
| Environment   | select (string) | Yes      | Environment for this feature flag operation. Options load from the selected connection. |
| Feature flag  | select (string) | Yes      | Feature flag to operate on. Options load from the selected connection.                  |
| Audit comment | textarea        | No       | Optional reason recorded with the change.                                               |

**Outputs**

| Field        | Type   | Description                                          |
| ------------ | ------ | ---------------------------------------------------- |
| Feature flag | object | Feature flag configuration returned by LaunchDarkly. |

#### Update Flag Targeting Rules

Update feature flag targeting in one LaunchDarkly environment.

**Required permissions:** `viewProject`, `updateTargets`, `updateFallthrough`.

**Inputs**

| Field                          | Type            | Required | Description                                                                                                                                                               |
| ------------------------------ | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Project                        | select (string) | Yes      | Project containing the feature flag. Options load from the selected connection.                                                                                           |
| Environment                    | select (string) | Yes      | Environment for this feature flag operation. Options load from the selected connection.                                                                                   |
| Feature flag                   | select (string) | Yes      | Feature flag to operate on. Options load from the selected connection.                                                                                                    |
| Targeting change               | select (string) | Yes      | Choose the targeting change to apply. Available values: Add targets, Remove targets, Set default variation, Set percentage rollout.                                       |
| Variation                      | select (string) | No       | Variation used for a target or default-variation change. Options load from the selected connection.                                                                       |
| Context kind                   | string          | No       | Kind of context identified by the target keys. Default: user.                                                                                                             |
| Target keys                    | textarea        | No       | Comma-separated context keys to add or remove.                                                                                                                            |
| Rollout configuration          | select (string) | No       | Choose two variations with a percentage, or custom multivariate allocations. Available values: Two variations, Custom multivariate allocations. Default: two\_variations. |
| Remainder variation            | select (string) | No       | Variation served to the remaining percentage of contexts. Options load from the selected connection.                                                                      |
| Selected variation percentage  | number          | No       | Percentage receiving the selected variation; the other receives the remainder.                                                                                            |
| Percentage rollout allocations | textarea        | No       | One variation ID and percentage per line.                                                                                                                                 |
| Bucket attribute               | string          | No       | Optional context attribute used to bucket the percentage rollout.                                                                                                         |
| Audit comment                  | textarea        | No       | Optional reason recorded with the change.                                                                                                                                 |

**Outputs**

| Field        | Type   | Description                                          |
| ------------ | ------ | ---------------------------------------------------- |
| Feature flag | object | Feature flag configuration returned by LaunchDarkly. |

#### Archive Feature Flag

Retire a feature flag without permanently deleting it. This is reversible, but LaunchDarkly rejects flags that are still prerequisites of other flags.

**Required permissions:** `updateGlobalArchived`.

**Inputs**

| Field         | Type            | Required | Description                                                                     |
| ------------- | --------------- | -------- | ------------------------------------------------------------------------------- |
| Project       | select (string) | Yes      | Project containing the feature flag. Options load from the selected connection. |
| Feature flag  | select (string) | Yes      | Feature flag to operate on. Options load from the selected connection.          |
| Audit comment | textarea        | No       | Optional reason recorded with the change.                                       |

**Outputs**

| Field        | Type   | Description                                          |
| ------------ | ------ | ---------------------------------------------------- |
| Feature flag | object | Feature flag configuration returned by LaunchDarkly. |

#### Delete Feature Flag

Permanently delete a feature flag across every environment. This cannot be undone. Use Get Feature Flag first and prefer Archive Feature Flag when recovery is needed.

**Required permissions:** `deleteFlag`.

**Inputs**

| Field            | Type            | Required | Description                                                                                                                                                                                                        |
| ---------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Project          | select (string) | Yes      | Project containing the feature flag. Options load from the selected connection.                                                                                                                                    |
| Feature flag     | select (string) | Yes      | Feature flag to permanently delete across every environment. This cannot be undone. Use Get Feature Flag first and prefer Archive Feature Flag when recovery is needed. Options load from the selected connection. |
| Confirm flag key | string          | Yes      | Type the feature flag key again to confirm permanent deletion.                                                                                                                                                     |

**Outputs**

| Field                    | Type   | Description                                                 |
| ------------------------ | ------ | ----------------------------------------------------------- |
| Deletion acknowledgement | object | Confirmation that the feature flag was permanently deleted. |

#### Copy Flag Settings Across Environments

Copy selected feature flag settings between environments. LaunchDarkly Enterprise is required.

**Required permissions:** `viewProject`, `copyFlagConfigFrom`, `copyFlagConfigTo`.

**Inputs**

| Field                  | Type            | Required | Description                                                                                                                                |
| ---------------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Project                | select (string) | Yes      | Project containing the feature flag. Options load from the selected connection.                                                            |
| Feature flag           | select (string) | Yes      | Feature flag to operate on. Options load from the selected connection.                                                                     |
| Source environment     | select (string) | Yes      | Environment to copy settings from. Options load from the selected connection.                                                              |
| Target environment     | select (string) | Yes      | Environment whose settings will be replaced. Options load from the selected connection.                                                    |
| Settings to copy       | select (string) | Yes      | Choose all settings, only selected categories, or all except selected. Available values: All settings, Only selected, All except selected. |
| Targeting on/off state | boolean         | No       | Select the flag's on/off targeting state. Default: false.                                                                                  |
| Targeting rules        | boolean         | No       | Select custom targeting rules. Default: false.                                                                                             |
| Default variation      | boolean         | No       | Select the default variation or rollout. Default: false.                                                                                   |
| Off variation          | boolean         | No       | Select the variation served when targeting is off. Default: false.                                                                         |
| Prerequisites          | boolean         | No       | Select prerequisite flag settings. Default: false.                                                                                         |
| Individual targets     | boolean         | No       | Select individual context targets. Default: false.                                                                                         |
| Migration settings     | boolean         | No       | Select migration flag settings when this is a migration flag. Default: false.                                                              |
| Audit comment          | textarea        | No       | Optional reason recorded with the change.                                                                                                  |

**Outputs**

| Field        | Type   | Description                                          |
| ------------ | ------ | ---------------------------------------------------- |
| Feature flag | object | Feature flag configuration returned by LaunchDarkly. |

#### Get Flag Status

Check a feature flag's lifecycle status in one environment.

**Required permissions:** `viewProject`.

**Inputs**

| Field        | Type            | Required | Description                                                                             |
| ------------ | --------------- | -------- | --------------------------------------------------------------------------------------- |
| Project      | select (string) | Yes      | Project containing the feature flag. Options load from the selected connection.         |
| Environment  | select (string) | Yes      | Environment for this feature flag operation. Options load from the selected connection. |
| Feature flag | select (string) | Yes      | Feature flag to operate on. Options load from the selected connection.                  |

**Outputs**

| Field               | Type   | Description                                                                  |
| ------------------- | ------ | ---------------------------------------------------------------------------- |
| Feature flag status | object | Lifecycle status and available request/default details for the feature flag. |

### Triggers

A trigger starts a workflow when its configured event occurs. Configure the event and filters before enabling the trigger.

#### Feature Flag Changed

Start a workflow when a feature flag changes in a LaunchDarkly project.

**Required permissions:** `viewProject`, `createWebhook`, `deleteWebhook`.

**Configuration**

| Field   | Type            | Required | Description                                                                                                                |
| ------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
| Project | select (string) | Yes      | The LaunchDarkly project whose feature flag changes should start this workflow. Options load from the selected connection. |

**Event inputs**

| Field            | Type     | Required | Description                                                |
| ---------------- | -------- | -------- | ---------------------------------------------------------- |
| Audit event ID   | string   | Yes      | The LaunchDarkly audit log entry ID.                       |
| Changed resource | string   | Yes      | The LaunchDarkly resource associated with the audit event. |
| Occurred at      | datetime | Yes      | When LaunchDarkly recorded the change.                     |
| Resource name    | string   | No       | The resource name, when supplied by LaunchDarkly.          |
| Change comment   | string   | No       | The optional comment recorded with the change.             |
| Change action    | string   | Yes      | The resource change action that matched this trigger.      |

**Outputs**

| Field            | Type     | Description                                                |
| ---------------- | -------- | ---------------------------------------------------------- |
| Audit event ID   | string   | The LaunchDarkly audit log entry ID.                       |
| Changed resource | string   | The LaunchDarkly resource associated with the audit event. |
| Occurred at      | datetime | When LaunchDarkly recorded the change.                     |
| Resource name    | string   | The resource name, when supplied by LaunchDarkly.          |
| Change comment   | string   | The optional comment recorded with the change.             |
| Change action    | string   | The resource change action that matched this trigger.      |

#### Trigger Approval Request Created

Start a workflow when a feature flag approval request is created.

**Required permissions:** `viewProject`, `createWebhook`, `deleteWebhook`.

**Configuration**

| Field       | Type            | Required | Description                                                                                                                 |
| ----------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
| Project     | select (string) | Yes      | The LaunchDarkly project containing the environment to watch. Options load from the selected connection.                    |
| Environment | select (string) | Yes      | The environment whose feature flag approval requests should start this workflow. Options load from the selected connection. |

**Event inputs**

| Field            | Type     | Required | Description                                                |
| ---------------- | -------- | -------- | ---------------------------------------------------------- |
| Audit event ID   | string   | Yes      | The LaunchDarkly audit log entry ID.                       |
| Changed resource | string   | Yes      | The LaunchDarkly resource associated with the audit event. |
| Occurred at      | datetime | Yes      | When LaunchDarkly recorded the change.                     |
| Resource name    | string   | No       | The resource name, when supplied by LaunchDarkly.          |
| Change comment   | string   | No       | The optional comment recorded with the change.             |

**Outputs**

| Field            | Type     | Description                                                |
| ---------------- | -------- | ---------------------------------------------------------- |
| Audit event ID   | string   | The LaunchDarkly audit log entry ID.                       |
| Changed resource | string   | The LaunchDarkly resource associated with the audit event. |
| Occurred at      | datetime | When LaunchDarkly recorded the change.                     |
| Resource name    | string   | The resource name, when supplied by LaunchDarkly.          |
| Change comment   | string   | The optional comment recorded with the change.             |

#### Trigger Segment Updated

Start a workflow when a segment changes in a LaunchDarkly environment.

**Required permissions:** `viewProject`, `createWebhook`, `deleteWebhook`.

**Configuration**

| Field       | Type            | Required | Description                                                                                                  |
| ----------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------ |
| Project     | select (string) | Yes      | The LaunchDarkly project containing the environment to watch. Options load from the selected connection.     |
| Environment | select (string) | Yes      | The environment whose segment updates should start this workflow. Options load from the selected connection. |

**Event inputs**

| Field            | Type     | Required | Description                                                |
| ---------------- | -------- | -------- | ---------------------------------------------------------- |
| Audit event ID   | string   | Yes      | The LaunchDarkly audit log entry ID.                       |
| Changed resource | string   | Yes      | The LaunchDarkly resource associated with the audit event. |
| Occurred at      | datetime | Yes      | When LaunchDarkly recorded the change.                     |
| Resource name    | string   | No       | The resource name, when supplied by LaunchDarkly.          |
| Change comment   | string   | No       | The optional comment recorded with the change.             |
| Change action    | string   | Yes      | The resource change action that matched this trigger.      |

**Outputs**

| Field            | Type     | Description                                                |
| ---------------- | -------- | ---------------------------------------------------------- |
| Audit event ID   | string   | The LaunchDarkly audit log entry ID.                       |
| Changed resource | string   | The LaunchDarkly resource associated with the audit event. |
| Occurred at      | datetime | When LaunchDarkly recorded the change.                     |
| Resource name    | string   | The resource name, when supplied by LaunchDarkly.          |
| Change comment   | string   | The optional comment recorded with the change.             |
| Change action    | string   | The resource change action that matched this trigger.      |

### Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/launchdarkly.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
