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

Reviewing approval requests

Read time: 4 minutes
Last edited: Dec 14, 2024

Overview

This topic explains how to review, approve, and decline approval requests.

If someone requests your approval on a flag or segment change, the request appears in the Approvals dashboard, in your email, and in your in-app inbox. Depending on the approval request, it also appears in the following places:

  • For flags, the approval request appears in the flag's "Pending changes" panel and, if you use the LaunchDarkly Slack or Microsoft Teams app, in a Slack or Teams notification.
  • For segments, the approval request appears in the segment's details page and, if you use the LaunchDarkly Slack app, in a Slack notification.

You can click through to view and approve or decline the request from any of these notifications.

You can also use the REST API: List approval requests, List approval requests for a flag, Get approval request for a flag

View approval requests from the Approvals dashboard

To view approval requests from the Approvals dashboard:

  1. Click Approvals in the left sidenav. The Approvals dashboard opens.
  2. Click the request name or click the overflow menu and select View details. The Review request screen opens.

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 checkmark 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 at the bottom of the left sidenav. 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

Segment approvals do not appear in Microsoft Teams

If someone requests your approval on a flag change and you use the LaunchDarkly Slack or Microsoft Teams app, you will receive a Slack or Teams notification. Segment approvals are also sent through Slack, but are not sent through 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 changes from the approval request details screen. You can also add additional reviewers.

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.
  • Add approvers: Request an additional reviewer for the changes. Click the + button next to the list of approvers and select additional members or teams. 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 changes. Adding approvers does not update how many approvals are required before you can apply the change.
  • Comment only: Leave a comment on the requested 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 approve or decline approval requests, and
  • requests using service tokens with a role that can approve or decline 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. To learn how to give permissions to a team to review approvals, read How to create an approval team.