Skip to content

For the complete documentation index, see llms.txt.

LaunchDarkly integration (beta)

Connect LaunchDarkly so Promptless can start documentation work when a feature flag changes. Connecting creates a webhook in your LaunchDarkly account that sends Promptless flag-change events from all your projects. The connection alone starts no work. A LaunchDarkly flag trigger decides which flag changes start documentation work.

Promptless reads projects and flag state, and it manages only its own webhook. It never edits a flag. The LaunchDarkly integration is in beta.

In this guide, you create a LaunchDarkly service token, connect it in Promptless, and disconnect when you no longer need flag-triggered work.

  • An admin role in your Promptless organization.
  • A LaunchDarkly account that can create access tokens.

You need an admin role in your Promptless organization to connect LaunchDarkly, and a LaunchDarkly account that can create access tokens.

  1. In LaunchDarkly, open Authorization settings and create an access token.

  2. Mark the token as a service token. A service token isn’t tied to an individual user, so the integration keeps working when team members leave.

  3. For the token’s role, select Inline policy.

  4. Enter this policy:

    [
    {
    "effect": "allow",
    "actions": ["createWebhook", "deleteWebhook"],
    "resources": ["webhook/*"]
    },
    {
    "effect": "allow",
    "actions": ["viewProject"],
    "resources": ["proj/*"]
    }
    ]

    The policy grants Promptless the minimum permissions it needs:

    • createWebhook and deleteWebhook on webhook/* let Promptless manage its subscription to flag-change events.
    • viewProject on proj/* lets Promptless view projects and flag state.
  5. Save the token, and copy it. For more on API access tokens, see the LaunchDarkly docs.

  6. On the Promptless Integrations page, select Connect LaunchDarkly.

  7. Paste the service token into the modal, and select Connect.

Promptless validates the token and creates a webhook in your LaunchDarkly account that delivers flag-change events. LaunchDarkly then shows as connected on the Integrations page.

Promptless authenticates to LaunchDarkly with the service token. It verifies each webhook delivery with an HMAC-SHA256 signature, using a signing secret unique to your connection.

  • On the Integrations page, on the LaunchDarkly card, select Disconnect LaunchDarkly.

Promptless removes its webhook from your LaunchDarkly account, and flag changes stop reaching Promptless. To revoke the service token too, delete it in LaunchDarkly’s Authorization settings.

  • LaunchDarkly flag trigger, to choose which flag changes start documentation work
  • Connection health, if a flag trigger stops starting documentation work after a disconnect, a revoked token, or a failed webhook signature check