No results for ""
EXPAND ALL
  • Home
  • API docs

Requesting approvals

Read time: 4 minutes
Last edited: Jul 12, 2024
Approvals is a Foundation and Enterprise feature

Approvals is available to customers on a Foundation or Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.

Requiring approvals by environment is available only to customers on an Enterprise plan. To learn more, read Configuring approvals by environment.

Overview

This topic explains how to create and delete approval requests.

Create an approval request

You can request approval on changes to a flag's targeting or variations from any member or team within your LaunchDarkly organization. You can do this any time after you create a flag. Members that do not have permission to approve requests can still view the change.

Here's how:

  1. Make a change to any flag.

  2. Click the dropdown icon in the Review and save button. The additional actions menu appears:

    The "Review and save" button with the additional actions menu expanded.
    The "Review and save" button with the additional actions menu expanded.
Your environment may require approvals

If your environment requires approvals, Review and request approval is the default option. To learn more, read Configuring approvals for an environment.

  1. Click "Request approval." The "Save changes" dialog appears.
  2. Review and confirm the changes displayed in the dialog.
  3. Enter a Reason to add details that help your reviewers understand the changes you made.
  4. Choose one or more reviewers from the Reviewers menu.
    • Members and teams with permission to approve or decline approval requests appear in the top section of the menu.
    • Members and teams that can only view approval requests appear in the bottom section of the menu. If you add a member or team from this list, they will be notified of the approval request, but cannot approve it.
  5. Click Request approval. The approval request appears.

Reviewers receive an email, an in-app inbox notification, and, if they use the LaunchDarkly Slack or Microsoft Teams app, a Slack or Teams notification asking them to approve your flag changes.

The flag's targeting page also updates with a number next to the Pending changes icon to indicate that there are pending changes waiting for review:

The "Pending changes" icon on a flag.
The "Pending changes" icon on a flag.

You can request approvals for changes to a flag's targeting or variations only. You cannot request approval on other flag changes, such as updates to a flag's settings.

You can also use the REST API: Create approval request for a flag

Required approvals

Enterprise customers can require approval requests for specific environments.

If your environment requires approvals, then when you make a flag change, Review and request approval is the default option. If a team member has the bypassRequiredApproval custom role action, they are not required to request approval. Instead, they have the option to Save changes.

When you copy flag settings between environments, if the environment you're copying changes to requires approval, then Review and request approval is the default option. To learn more, read Compare and copy flag settings between two environments and Configuring approvals for an environment.

Delete an approval request

You may delete your request for changes to a flag at any point before the changes are applied. You can do this in several ways:

  • from the Approvals dashboard, or
  • from the "Pending changes" panel, or
  • from the approval request.

You can also use the REST API: Delete approval request for a flag

Delete an approval request from the Approvals dashboard

To delete approval requests from the Approvals dashboard:

  1. Click Approvals in the left sidenav. The Approvals dashboard opens.
  2. Find the request you wish to delete and click the overflow menu.
The overflow menu with the "Delete request" option called out.
The overflow menu with the "Delete request" option called out.
  1. Choose "Delete request." A confirmation dialog appears.
  2. Type the flag's key to confirm.
  3. Click Delete. The request is deleted.

Delete an approval request from the "Pending changes" panel

To delete approval requests from a flag's "Pending changes" panel:

  1. Navigate to the flag's targeting page and click the Pending changes icon. The "Pending changes" panel appears.
  2. Find the change you wish to delete and click the overflow menu. Additional options appear:
The "Delete" option in the overflow menu.
The "Delete" option in the overflow menu.
  1. Choose Delete. A confirmation dialog appears.
  2. Type the flag's name or key to confirm.
  3. Click Delete. The request is deleted.

Delete an approval request from the request details screen

To delete an approval request from the request details screen:

  1. Navigate to the request details screen from the Approvals dashboard, flag, or approval notification.
  2. Click the overflow menu and choose "Delete request." A confirmation dialog appears.
The overflow menu expanded with the "Delete request" option.
The overflow menu expanded with the "Delete request" option.
  1. Enter the flag's name or key to confirm.
  2. Click Delete request. The request is deleted.