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

# Review Queue

> Configure qualified reviewers, inspect governed assets, and record staged approval decisions.

WriterzRoom turns governance obligations from each content passport into durable review work. Required reviews are routed after generation, assigned to qualified organization members, and visible at **Reviews**.

<Warning>
  Approval decisions are recorded and synchronized to the content passport, but they do not currently block publication. Treat the queue as an auditable review workflow, not as a publication lock.
</Warning>

## Qualifications and Permissions

Review qualifications describe subject-matter competency. Workspace roles describe product access. They are separate controls.

| Control              | Values                                                 | What it means                                                   |
| -------------------- | ------------------------------------------------------ | --------------------------------------------------------------- |
| Workspace permission | `admin`, `editor`, `viewer`                            | What a member can do in the organization                        |
| Review qualification | `medical`, `legal`, `compliance`, `brand`, `editorial` | Which governed review obligations may be assigned to the member |

An administrator does not automatically qualify for any governed review. Organization admins set qualifications under **Workspace → Team** after a member accepts the invitation.

## How Assignment Works

1. The Quality Gate records required approvals in the asset's content passport.
2. The generation finalizer persists those obligations as review records.
3. For each role, WriterzRoom selects an active organization member with the matching qualification.
4. Selection is deterministic for the request-and-role pair, so retries do not move work unexpectedly.
5. Reviews at the same stage can proceed in parallel; later stages wait until earlier required reviews are resolved.

If no qualified member exists, the obligation remains unassigned. Adding a qualification assigns matching pending work immediately. Removing a qualification revokes that member's pending assignments and reroutes them when another eligible reviewer exists.

## Review an Asset

<Steps>
  <Step title="Open Reviews">
    Open **Reviews** from the application navigation. The queue includes work you own and work assigned to you.
  </Step>

  <Step title="Inspect the record">
    Review the full asset, required role and reason, content passport, quality report, evidence, due date, and sibling review state.
  </Step>

  <Step title="Record a decision">
    Choose **Approve**, **Request changes**, **Reject**, or **Waive**. Required later-stage reviews remain locked until the current stage is resolved.
  </Step>

  <Step title="Request evidence when needed">
    A changes request can name the claim, source index, and missing substantiation so the next revision has an auditable checklist rather than only free-form feedback.
  </Step>
</Steps>

## Recovery and Escalation

An internal hourly sweep repairs missing or partial review routes, assigns unassigned work when qualified members become available, and marks overdue approvals for escalation. Immediate routing remains the normal path; the sweep is a recovery control.

## API

All endpoints below use the standard API base URL and authenticated user API key.

| Method  | Endpoint                               | Purpose                                                                |
| ------- | -------------------------------------- | ---------------------------------------------------------------------- |
| `GET`   | `/approvals?status=pending&role=legal` | List owned or assigned reviews                                         |
| `GET`   | `/approvals/{request_id}`              | Retrieve every review and rollup state for an asset                    |
| `POST`  | `/approvals/{request_id}/route`        | Idempotently derive and persist missing obligations                    |
| `GET`   | `/approvals/{approval_id}/asset`       | Inspect the asset, passport, quality report, and actionability         |
| `PATCH` | `/approvals/{approval_id}/assign`      | Assign or clear a qualified reviewer; owner or organization admin only |
| `POST`  | `/approvals/{approval_id}/decide`      | Record the reviewer's decision and evidence requests                   |

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "status": "changes_requested",
  "notes": "Substantiate the market-size statement.",
  "evidence_requests": [
    {
      "claim_text": "The market exceeded $20B in 2025.",
      "source_index": 2,
      "note": "Provide the primary report and page reference."
    }
  ]
}
```

<CardGroup cols={2}>
  <Card title="Content Governance" icon="shield-check" href="/architecture/content-governance">
    Learn how review obligations are derived and recorded.
  </Card>

  <Card title="Workspace" icon="users" href="/product/workspace">
    Manage organization members and permissions.
  </Card>
</CardGroup>