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

GIVE DOCS FEEDBACK

Reviewing approval requests

Read time: 4 minutes
Last edited: May 01, 2024
Approvals is a Pro and Enterprise feature

Approvals is available to customers on a Pro 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 review, approve, and decline approval requests.

View flag approval requests

If someone requests your approval on a flag change, the request appears in the Approvals dashboard and in the flag's "Pending changes" panel.

You will receive an email, an in-app inbox notification, and, if you use the LaunchDarkly Slack or Microsoft Teams app, a Slack or Teams notification. You can click through to view and approve or decline the request from any of these notifications.

View approval requests from the Approvals dashboard

To view approval requests from the Approvals dashboard:

  1. Click the approval icon in the top menu bar. The Approvals dashboard opens.
The top menu bar, with the "Approval" icon called out.
The top menu bar, with the "Approval" icon called out.
  1. Click the request name or click the overflow menu and select "View details." The Review request screen opens.
The overflow menu with the "View details" option called out.
The overflow menu with the "View details" option called out.

By default, the Approvals dashboard is filtered to show approval requests on which you have been requested as a reviewer, and which are pending review. To see other approval requests, you can edit the filters to change the views on this screen.

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

View approval requests from the flag

To view approval requests from a flag:

  1. Navigate to the flag where changes were requested.
  2. Click the Pending changes icon. The Pending changes panel opens.
The "Pending changes" icon on a flag.
The "Pending changes" icon on a flag.
  1. Click View to open the approval request details screen.

View approval requests from email

To view approval requests from your email:

  1. Find the email from "The Team at LaunchDarkly" in your email client. The email subject includes the name of the project, environment, and flag you're being asked to review and the phrase "Review request."
  2. In the message body, click Review request to open the approval request details screen in LaunchDarkly.

View approval requests from your in-app inbox

To view approval notifications from your in-app inbox:

  1. Click the bell icon in the top menu bar. The approval notification inbox appears.
The approval notification inbox with a new approval request.
The approval notification inbox with a new approval request.
  1. Click View Details. The approval request details screen opens.

View approval requests from Slack or Microsoft Teams

If you use the LaunchDarkly Slack or Microsoft Teams app, you will receive a notification of each approval request through that app.

To learn more, read View approvals in Slack and View approvals in Microsoft Teams.

To learn more about these integrations, read Slack and Microsoft Teams.

Approve and decline changes

You can comment on, approve, and decline flag changes from the approval request details screen.

Here are the actions you can take during your review:

  • Approve and apply changes: Approve the changes and apply them immediately. The "Review history" section updates to indicate that you reviewed the change request, and the requestor receives an email notification. If scheduled for a future date, the change will apply at the scheduled date and time.
  • Approve changes: Approve the changes without applying them. The original requester, or any account member with a Writer, Admin, Owner, or appropriate custom role can apply the changes you approved.
  • Decline changes: Deny the changes.
  • Comment only: Leave a comment on the requested flag changes.
Anyone with role access can leave a comment

Members and service tokens with role access can comment on an approval request, including:

  • the requestor,
  • members with a role of Writer, Admin, or Owner,
  • members with a custom role that can review approval requests, and
  • requests using service tokens with a role that can review approval requests.

The only time someone with access cannot comment on an approval request is after the request has been applied. Applying an approval request freezes the approval request page to preserve the state it was in when the change was applied.

Member accounts and service tokens have permission to approve and apply changes to an approval request.