# Approvals

The approval inbox: review pending access requests, approve or reject them with a reason, and view decided requests.

Requires: workflows

> **Plan note:** Approvals are part of approval workflows, available on the Advanced plan and above (Trial includes up to 3 workflows). See [Plans & add-ons](https://dts-identity.com/docs/getting-started/plans-and-addons.md).

The **Approvals** area is the shared inbox for two kinds of work: access requests that an [approval flow](https://dts-identity.com/docs/workflows/approval-flows.md) has routed to human reviewers, and access reviews that an [access certification](https://dts-identity.com/docs/workflows/access-certifications.md) campaign has routed to reviewers. Open it from **Approvals** in the Admin Console. Requests and reviews appear here as soon as they reach someone who can act on them; access reviews are shown separately, under an **Active access reviews** (or **Closed access reviews**) heading.

[Image: The Approvals inbox with three pending access requests]

## Tabs

The inbox has three tabs:

- **Open & active** — requests and access reviews that are still pending a decision.
- **Remediations** — revoked access reviews that still need a manual follow-up, collected across all campaigns (see [access certifications](https://dts-identity.com/docs/workflows/access-certifications.md#what-revoke-does-and-does-not-do)). The tab shows the open count; it appears empty once everything is resolved.
- **Closed** — requests that have been approved, rejected, or ended in an error, and access reviews that were decided, cancelled, or left unreviewed.

Each entry shows the requester or reviewed user, the application, and the status.

## Review a request

You can act on a request only when you are one of the **current approvers** — that is, an eligible approver at the level the request is currently waiting on. For those requests, three actions are available:

- **Details** — opens the full context of the request: who asked, for which application, and any reason they gave.
- **Approve** — grants approval at the current level.
- **Reject** — denies the request.

If a request is waiting on a different level or a different approver, it appears in the inbox without action buttons.

### What approvals can and cannot do

Keep your expectations to what the inbox supports:

- **One at a time.** You act on each request individually — there is no bulk approve or bulk reject.
- **No discussion thread.** A request carries the requester's original reason; there is no back-and-forth comment exchange on it. Decide from the details shown, or follow up out of band.
- **No reassignment.** You cannot hand a request to a different approver. Only an eligible current approver can act on it — if that is not you, it stays in someone else's inbox until they decide.

### Approve a request

1. Open the request and select **Approve**.
2. Optionally set a **start date** and **end date** to bound how long the granted access should last.
3. Confirm.

Because each level only needs **one** approver, your approval advances the request:

- If there are further approval levels, the next level's approvers are notified and the request stays pending.
- If yours was the final level, access is **granted** — the platform performs the assignment automatically, honoring any start and end date — and the requester is notified.

Nobody approves their own request: if a named approver is also the requester, the approval is refused for them and another approver of the level has to decide. If they are the only approver of the level, the request stays pending. Rejecting your own request is possible.

### Reject a request

1. Open the request and select **Reject**.
2. Confirm the rejection.

A rejection ends the request immediately and notifies the requester. No further levels are consulted.

## History

Switch to the **Closed** tab to review decided requests — approved, rejected, or errored. Open **Details** on any entry to see its full context. Closed requests can be **deleted** to clear them from the list; the decision itself remains recorded in the [audit log](https://dts-identity.com/docs/monitoring/audit-logs.md).

## Where else requests appear

An approval or access review waiting on you also surfaces in **Your tasks**, the cross-cutting "what needs me?" view. Acting on it in either place resolves it everywhere. See [Your tasks & approvals](https://dts-identity.com/docs/getting-started/your-tasks-and-approvals.md).

## Reference

### Request statuses

| Status | Meaning |
|---|---|
| Pending | Awaiting a decision at the current approval level |
| Approved | Fully approved; access has been granted |
| Rejected | Denied by an approver |
| Error | The request could not be processed (for example, an approval level had no valid approvers) |

### Access review outcomes

| Status | Meaning |
|---|---|
| Pending | Awaiting certify or revoke by a reviewer |
| Approved | Certified as still needed by a reviewer |
| Revoked | Access removed by a reviewer |
| Unreviewed | The campaign closed before a reviewer decided; access is left unchanged |

See [Access certifications](https://dts-identity.com/docs/workflows/access-certifications.md) for how these reviews are created and what certify/revoke do.

## Troubleshooting

- **A request shows no Approve/Reject buttons.** You are not a current approver for it — it is waiting on a different level or different people. It will become actionable for you only if it reaches a level whose approvers include you.
- **A request is in error.** The approval flow's rule reached a level with no approvers configured. Fix the flow's rule (see [Approval flows](https://dts-identity.com/docs/workflows/approval-flows.md)) and re-publish; in-flight requests are reset to re-evaluate.
- **A pending request vanished or restarted.** Publishing a change to the underlying flow resets in-flight requests so they re-evaluate against the new rules.

## Related

- [Approval flows](https://dts-identity.com/docs/workflows/approval-flows.md) — how requests are created and routed
- [Your tasks & approvals](https://dts-identity.com/docs/getting-started/your-tasks-and-approvals.md) — your personal action list
- [Audit logs](https://dts-identity.com/docs/monitoring/audit-logs.md) — the permanent record of approval decisions
- [Glossary](https://dts-identity.com/docs/reference/glossary.md) — terminology used across these docs
