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

# Promotion Requests

> Review and decide pending variable promotion requests in the desktop app.

<Card title="Read the shared key re-sharing model" icon="circle-info" href="/fundamentals/v2/security-and-operations/key-re-sharing">
  Promotion review and key access are related. Use this page for desktop-specific review flow.
</Card>

Promotion requests let teammates propose cross-environment key updates while requiring an explicit
human decision before target values are changed.

## Where Requests Appear

In desktop, pending requests can surface in multiple places:

* project environment cards (pending request indicators),
* target environment Variables view (pending review banner),
* review entry points that deep-link to the target environment.

<img className="block dark:hidden w-full" src="https://mintcdn.com/ghostable/Ri2hNopezE87fRv1/images/desktop-promotion-where-requests-appear-light.png?fit=max&auto=format&n=Ri2hNopezE87fRv1&q=85&s=3b48cbf1d66a81165aebd10ac40da947" alt="Ghostable desktop environments view in light mode showing a pending promotion review banner and pending indicators on environment cards." width="2080" height="1384" data-path="images/desktop-promotion-where-requests-appear-light.png" />

<img className="hidden dark:block w-full" src="https://mintcdn.com/ghostable/Ri2hNopezE87fRv1/images/desktop-promotion-where-requests-appear-dark.png?fit=max&auto=format&n=Ri2hNopezE87fRv1&q=85&s=d73bc398bc1e47c3402ba4a6f26981a0" alt="Ghostable desktop environments view in dark mode showing a pending promotion review banner and pending indicators on environment cards." width="2080" height="1384" data-path="images/desktop-promotion-where-requests-appear-dark.png" />

## Review Flow

From a pending request entry point, choose **Review** to open the promotion review modal.

The review flow shows:

* requester + source to target direction,
* requested key list,
* whether values were included in the request,
* current request status.

<img className="block dark:hidden w-full" src="https://mintcdn.com/ghostable/Ri2hNopezE87fRv1/images/desktop/promotion-review-light.png?fit=max&auto=format&n=Ri2hNopezE87fRv1&q=85&s=95ab87a3ba6ae44f134bbb0c71c458ec" alt="Ghostable desktop review promotion request modal in light mode with approve and reject decision controls." width="597" height="364" data-path="images/desktop/promotion-review-light.png" />

<img className="hidden dark:block w-full" src="https://mintcdn.com/ghostable/Ri2hNopezE87fRv1/images/desktop/promotion-review-dark.png?fit=max&auto=format&n=Ri2hNopezE87fRv1&q=85&s=22676933e77e61cca54bb32cd7ceb618" alt="Ghostable desktop review promotion request modal in dark mode with approve and reject decision controls." width="597" height="364" data-path="images/desktop/promotion-review-dark.png" />

## Decisions

Choose one decision in the modal:

* **Approve** (default)
* **Reject**

When rejecting, provide an optional rejection reason.

When approving, you can provide or override values as needed for individual keys before final
submit.

## Included Value Decryption Warnings

If a request includes values but your device cannot decrypt one or more of them, desktop shows a
warning and lets you provide explicit values during approval.

Common cause: the request was created before this device received the relevant environment key
shares.

<img className="block dark:hidden w-full" src="https://mintcdn.com/ghostable/Ri2hNopezE87fRv1/images/desktop/promotion-review-cannot-decrypt-light.png?fit=max&auto=format&n=Ri2hNopezE87fRv1&q=85&s=44a9ab28dc4e764f18565d75f55b4ef2" alt="Ghostable desktop promotion review warning in light mode indicating one or more included values could not be decrypted on this device." width="597" height="364" data-path="images/desktop/promotion-review-cannot-decrypt-light.png" />

<img className="hidden dark:block w-full" src="https://mintcdn.com/ghostable/Ri2hNopezE87fRv1/images/desktop/promotion-review-cannot-decrypt-dark.png?fit=max&auto=format&n=Ri2hNopezE87fRv1&q=85&s=874e83ec3d85cce7f2a29f7d90d4698f" alt="Ghostable desktop promotion review warning in dark mode indicating one or more included values could not be decrypted on this device." width="597" height="364" data-path="images/desktop/promotion-review-cannot-decrypt-dark.png" />

## Permissions and Safety

Desktop enforces environment permissions from the API:

* reviewers need target-environment write capability to approve,
* sensitive data remains client-side encrypted,
* request and activity records remain metadata-forward for auditability.

## Continue

<CardGroup>
  <Card title="Environments and variables" icon="key" href="/desktop/v1/daily-work/environments-and-variables">
    Return to the primary environment editing workspace.
  </Card>

  <Card title="Validation and history" icon="clock" href="/desktop/v1/daily-work/validation-and-history">
    Review project/environment history and validation workflows.
  </Card>
</CardGroup>
