---
title: "Run Review Manual"
method: POST
path: "/companies/{company_id}/review/run"
tags: ["statement-review"]
---

# Run Review Manual

`POST /companies/{company_id}/review/run`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/companies/{company_id}/review/run`
- Auth: none declared

Full re-review of one subject, persisted (accountant).

Runs every registered check (not just the cheap on-read subset) and
persists the run + finding state.

## Path parameters

- `company_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- ReviewRunRequestIn: Manual re-review request (``POST …/review/run``). ``subject_kind`` picks the family; the scope params identify the instance (``fiscal_year`` for statements, ``month`` optional).
  - `subject_kind` string, required
  - `fiscal_year` integer, nullable
  - `month` string, nullable
  - `period_id` string, nullable
  - `target_id` string, nullable

## Response `201`

Successful Response

- ReviewRunResponseOut
  - `run_id` string, required
  - `review` ReviewBlockOut, required: The uniform ``review`` block artifact endpoints embed (computed live).
    - `verdict` string, required
    - `summary` string, required
    - `plan` integer[]
    - `findings` ReviewFindingOut[]
      - `finding_identity` string, required
      - `code` string, required
      - `check_class` string, required
      - `severity` string, required
      - `title` string, required
      - `detail` string
      - `expected_cents` integer, nullable
      - `actual_cents` integer, nullable
      - `delta_cents` integer, nullable
      - `dimension` object
      - `settings_implicated` string[]
      - `evidence` object
      - `remediation` RemediationOut: Deterministic resolution instructions for one finding.
        - `what_it_means` string, required
        - `why_it_matters` string, required
        - `steps` string[], required
        - `deep_link` string, nullable
        - `who_can_fix` string, required
        - `fix_with_ai` boolean
      - `blocking` boolean
      - `subject_kind` string, nullable
      - `subject_id` string, nullable
      - `first_seen_at` string, nullable
      - `resolved_at` string, nullable
      - `ack_by` string, nullable
      - `ack_at` string, nullable
      - `ack_reason` string, nullable
      - `ack_treatment` string, nullable
      - `ack_treatments` ReviewAckTreatmentOut[]
        - `key` string, required
        - `label` string, required
      - `ai_assessment` object, nullable
    - `coverage` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)
