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

# Access Reviews

> An Access Review is a campaign that reviews who has access to what across your apps. v1 syncs an app review and reads its subjects.

An Access Review is a campaign that reviews who has access to what across your connected apps.
Each app in it is an app review. Inside an app review, reviewers decide on
[subjects](https://docs.lumos.com/reference/v1/objects/access-review-subject.md): the accounts on the app, or the
entitlements those accounts hold.

v1 can sync an app review and read its subjects. It can't create, list, or update Access Reviews
yet, so do that in the Lumos web app.

> [!NOTE]
>
> Lumos enables the Access Reviews endpoints per organization, separately from the rest of v1. To
> enable them for your organization, contact your Lumos representative.

## App reviews

Reviewers decide on a snapshot of the app, not on live data. Lumos takes the snapshot when the app
is added to the Access Review, and takes it again when you call
[Sync App Review](https://docs.lumos.com/api-reference/v1/access-reviews/sync-app-review.md). The same call can replace the
app review's scope filters, as its reference page describes.

You can sync an app review until the Access Review launches. After that, the call returns `409`
with `code` `app_review.launched`. A sync that's already running returns `409` with `code`
`app_review.sync_in_progress`.

The call returns `202` with an operation. Poll it until it's done, as
[Long-running operations](https://docs.lumos.com/reference/v1/long-running-operations.md#app-review-sync) describes. A call
you aren't allowed to make returns `403`.

## Endpoints

| Endpoint | Path |
| - | - |
| [Sync App Review](https://docs.lumos.com/api-reference/v1/access-reviews/sync-app-review.md) | `POST /v1/access-reviews/{review_uuid}/apps/{app_review_uuid}:sync` |
| [List Subject Filters](https://docs.lumos.com/api-reference/v1/access-reviews/list-subject-filters.md) | `GET /v1/access-reviews/{review_uuid}/apps/{app_review_uuid}/subject-filters` |
| [Get Subject](https://docs.lumos.com/api-reference/v1/access-reviews/get-subject.md) | `GET /v1/access-reviews/{review_uuid}/apps/{app_review_uuid}/subjects/{subject_uuid}` |