LaunchDarkly

LaunchDarkly is a feature flag management platform. By integrating LaunchDarkly with DX, you can analyze feature flags and incorporate LaunchDarkly data in DX scorecards. Please refer to the API documentation below and our schema explorer to see what data DX imports.

Prerequisites

To connect LaunchDarkly to DX, you need:

a LaunchDarkly Enterprise workspace
a LaunchDarkly API token

Setup instructions

Follow the steps below to connect JSM to DX.

Step 1

To generate an API token:

Browse to Account Settings > Security > Authorization.
Select API version 20220603 or 20240415 and use a token with the Reader role.
For long-term use, it is recommend that you enable the “service token” option (an Enterprise feature) which you can learn more about here.

Step 2

Navigate to the connections page in DX and select “+ Connection” in the top right.
Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.

API reference

The table below lists the specific API endpoints that are used by DX.

Endpoint	Documentation
/api/v2/projects	Link
/api/v2/tags	Link
/api/v2/teams	Link
/api/v2/teams/{teamKey}/maintainers	Link
/api/v2/flags/	Link
/api/v2/projects/{projectKey}/environments	Link
/api/v2/flag-statuses/{projectKey}/{environmentKey}/	Link

Errors

The table below lists potential error codes when adding a connection in DX.

Error	Description
`invalid_credentials`	Your API credentials entered are not valid.
`invalid_permissions`	Your API token does not have the permissions required by DX.