> ## Documentation Index
> Fetch the complete documentation index at: https://launchdarkly-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Reviewing approval requests

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

> For the complete documentation index, see [llms.txt](/llms.txt). For the full documentation snapshot, see [llms-full.txt](/llms-full.txt).

## Overview

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

If someone requests your approval on a flag, AI Config, 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 AI Configs, the approval request appears in the AI Config's "Pending changes" panel and, if you use the LaunchDarkly Slack app, in a Slack 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.

<Card icon="link">
  You can also use the REST API: [List approval requests](/api-reference/approvals/list-approval-requests)
</Card>

## View approval requests

You can view approval requests from:

* The [Approvals dashboard](#view-approval-requests-from-the-approvals-dashboard)
* The [affected flag or AI Config](#view-approval-requests-from-the-flag-or-ai-config)
* The [email notification](#view-approval-requests-from-email)
* Your [in-app inbox](#view-approval-requests-from-your-in-app-inbox)
* [Slack or Microsoft Teams](#view-approval-requests-from-slack-or-microsoft-teams), if you have those integrations configuredWhen viewing approval requests, you can review either a **Visual** list or a **JSON** list of the proposed changes:

<Frame caption="An approval request to toggle on a flag.">
  ![An approval request to toggle on a flag.](https://files.buildwithfern.com/https://launchdarkly.docs.buildwithfern.com/docs/43583c1ca145f89250c3142f7f218b638a790e0ff933a471ee857f5b0f46caa5/assets/images/auto/workflows-approval-request.auto.png)
</Frame>

To view the approximate percentage of contexts that will receive each flag variation after the targeting change, click **Test run**. To learn more, read [Testing changes to flag targeting](/home/flags/preview-rules).

### 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.

<Card icon="link">
  You can also use the REST API: [Review approval request](/api-reference/approvals/review-approval-request-for-a-flag)
</Card>

### View approval requests from the flag or AI Config

To view approval requests from a flag or AI Config:

1. Navigate to the flag or AI Config where changes were requested.
2. Click the "Pending changes" section in the right sidebar, or the **checkmark** pending changes icon. The "Pending changes" panel opens.

<Frame caption="The &#x22;Pending changes&#x22; section of a flag.">
  ![The "Pending changes" section of a flag.](https://files.buildwithfern.com/https://launchdarkly.docs.buildwithfern.com/docs/31059e21513186f311e41456eb55daefd78e9791f08e208300898f8544af2aa8/assets/images/auto/workflows-pending-changes-sidebar.auto.png)
</Frame>

3. Click **View** to open the approval request details screen.

<Card icon="link">
  You can also use the REST API: [List approval requests](/api-reference/approvals/list-approval-requests)
</Card>

### 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 or AI Config 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.

<Frame caption="The approval notification inbox with a new approval request.">
  ![The approval notification inbox with a new approval request.](https://files.buildwithfern.com/https://launchdarkly.docs.buildwithfern.com/docs/2e3beef1fa8db1278809256d2c958a4bcb61529f7eeabece083c57775aa6ebc9/assets/images/__LD_UI_no_test/approvals-approval-request-notification.png)
</Frame>

2. Click **View details**. The approval request details screen opens.

### View approval requests from Slack or Microsoft Teams

<Warning title="AI Config and 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. AI Config and segment approvals are also sent through Slack, but are not sent through Microsoft Teams.
</Warning>

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](/integrations/slack/approvals#view-approvals-in-slack) and [View approvals in Microsoft Teams](/integrations/microsoft-teams/approvals#view-approvals-in-microsoft-teams).

To learn more about these integrations, read [Slack](/integrations/slack) and [Microsoft Teams](/integrations/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. After approval, the original requester, or any account member with an `applyApprovalRequest` [permission](/home/account/roles/role-actions) can apply the changes you approved. The LaunchDarkly Project Admin, Maintainer, Developer, and Contributor [project roles](/home/account/roles/project-roles), as well as the Writer, Admin, and Owner base roles, all include this ability.
* **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.

<Note title="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 base role of Writer, Admin, or Owner
  * members with any role that can approve or decline approval requests
  * 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.
</Note>

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](https://support.launchdarkly.com/hc/en-us/articles/17378761056795-How-to-create-an-approval-team).

<Card icon="link">
  You can also use the REST API: [Review approval request](/api-reference/approvals/review-approval-request-for-a-flag)
</Card>
