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

# Requesting approvals

<View title="Developer" />

<View title="Federal docs" />

<View title="EU docs" />

This topic explains how to create approval requests.

## Create approval requests

You can request approval from any member or team within your LaunchDarkly organization for the following types of changes:

* Changes to a flag, segment, or AgentControl config's targeting
* Changes to a flag or AgentControl config's variations
* Starting, stopping, or editing an experiment

You can request approval for resource changes at any time after you create them. Members that do not have permission to approve requests can still open or review the request.

<Note>
  **Approvals on release phases work differently**

  If you use approvals to gate a phase in [release assistant](/docs/home/releases/release-pipelines), the phase must have an associated flag action. If the phase has no flag action, LaunchDarkly does not generate an approval request and the release phase completes automatically.
</Note>

### Create approval requests for flags, AgentControl configs, and segments

To request an approval:

1. Make a change to any flag, AgentControl config, or segment.
2. Click **Review and save**. The "Save changes" dialog appears.
3. Review the changes displayed in the dialog.

<Frame caption="The &#x22;Save changes&#x22; dialog with the &#x22;Schedule changes&#x22; and &#x22;Add reviewers&#x22; icons called out.">
  <img src="https://mintcdn.com/launchdarkly/7dOLLfhGme_BglBp/images/__LD_UI_no_test/save-changes-schedule-reviewers.png?fit=max&auto=format&n=7dOLLfhGme_BglBp&q=85&s=5e5872c796d499d35bcb8caa3bd8dc64" alt="The &#x22;Save changes&#x22; dialog with the &#x22;Schedule changes&#x22; and &#x22;Add reviewers&#x22; icons called out." width="1290" height="996" data-path="images/__LD_UI_no_test/save-changes-schedule-reviewers.png" />
</Frame>

4. (Optional) Click the **calendar** icon to schedule the change.
   1. Select a date, time, and timezone.
   2. Click **Update**.

5. Click the **person** icon to open the **Save changes** menu.

6. Choose one or more reviewers from the **Reviewer(s)** menu.

7. Enter a **Comment** to add details that help your reviewers understand the changes you made. If your organization uses a third-party workflow management system for approvals, you may need to complete additional fields. To learn more, read [Configuring approvals for an environment](/docs/home/releases/approval-config).

   <Note>
     **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](/docs/home/releases/approval-config).
   </Note>

8. **Confirm** your changes by entering the name of your environment.

9. Click **Request approval**.

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

<Warning>
  **AgentControl config and segment approvals do not appear in Microsoft Teams**

  If someone requests your approval on a flag or experiment change and you use the LaunchDarkly Slack or Microsoft Teams app, you will receive a Slack or Teams notification. AgentControl config and segment approvals are also sent through Slack, but are not sent through Microsoft Teams.
</Warning>

To learn more, read [Reviewing approval requests](/docs/home/releases/approval-reviews).

The "Pending changes" section in the flag, AgentControl config, or segment's right sidebar indicates that there are pending changes waiting for review. A flag or AgentControl config's **Targeting** tab also updates with a number next to the **checkmark** pending changes icon.

<Frame caption="The &#x22;Pending changes&#x22; section of a flag.">
  <img src="https://mintcdn.com/launchdarkly/ppwc2LYsjE8wwIC_/images/auto/workflows-pending-changes-sidebar.auto.png?fit=max&auto=format&n=ppwc2LYsjE8wwIC_&q=85&s=f7b735e2598d8d1c8f42dd7e020556dd" alt="The &#x22;Pending changes&#x22; section of a flag." width="586" height="180" data-path="images/auto/workflows-pending-changes-sidebar.auto.png" />
</Frame>

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

<Card icon="https://mintcdn.com/launchdarkly/YIC2H8XW-fomhquw/assets/icons/openapi-logo.svg?fit=max&auto=format&n=YIC2H8XW-fomhquw&q=85&s=dd9578a9668a86e1a8b8c314921f204c" horizontal width="2500" height="2452" data-path="assets/icons/openapi-logo.svg">
  You can also use the REST API: [Create approval request for a flag](/docs/api/approvals/create-approval-request-for-a-flag)
</Card>

### Create approval requests for experiments

You can create approval requests when you make a change to an experiment's design, or when you want to start or stop an experiment.

#### Create approval requests for changes to experiments

To request an approval when you make a change to an experiment's design:

1. Navigate to an experiment's **Design** tab, and make any changes needed.
2. Click **Save & request approval for new iteration**. A "Request approval to start new iteration" dialog appears.
3. Enter a **Reason for changes**.
4. Click **Continue**.
5. Choose one or more reviewers from the **Reviewer(s)** menu.
6. Enter a **Comment**.
7. Click **Request to start new iteration**.

#### Create approval requests for starting or stopping an experiment

To request an approval when you want to start or stop an experiment:

1. Navigate to an experiment's **Design** tab.
2. Click **Request approval to start** or **Request approval to stop**. A "Request approval to start/stop experiment" dialog appears.
3. Choose one or more reviewers from the **Reviewer(s)** menu.
4. Enter a **Comment**.
5. Click **Request to start/stop experiment**.

## Required approvals

Enterprise customers can require approval requests for specific environments.

If your environment requires approvals, **Review and request approval** is the default option when you make a flag, AgentControl config, experiment, or segment change. 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**. The `bypassRequiredApproval` custom role action applies to flag approvals. To bypass required approvals for segments, use the `bypassRequiredSegmentApproval` custom role action. You cannot bypass required approvals for AgentControl configs.

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](/docs/home/flags/compare-copy#compare-and-copy-flag-settings-between-two-environments) and [Configuring approvals for an environment](/docs/home/releases/approval-config).

<Card icon="https://mintcdn.com/launchdarkly/YIC2H8XW-fomhquw/assets/icons/openapi-logo.svg?fit=max&auto=format&n=YIC2H8XW-fomhquw&q=85&s=dd9578a9668a86e1a8b8c314921f204c" horizontal width="2500" height="2452" data-path="assets/icons/openapi-logo.svg">
  You can also use the REST API: [Create approval request to copy flag configurations across environments](/docs/api/approvals/create-approval-request-to-copy-flag-configurations-across-environments)
</Card>

To learn how to delete approval requests, read [Deleting approval requests](/docs/home/releases/approvals-delete).
