---
title: "Record a periodic review of a year's memo"
method: POST
path: "/net-zero/action-memos/{year}/reviews"
---

# Record a periodic review of a year's memo

`POST /net-zero/action-memos/{year}/reviews`

Applies each change's status (and progress note, when given) and records the review in one transaction, with each action's title and from and to statuses. An action that is not on the memo, a repeated action, an unknown status or period, or text over its limit is 400 VALIDATION_ERROR and nothing is written. Requires org.edit_dashboard.

## Path parameters

- `year` integer, required

## Request body

- NetZeroActionReviewCreate
  - `changes` NetZeroActionReviewChangeInput[]
    - `actionId` string, uuid, required
    - `progressNote` string — Left out or empty keeps the action's note.
    - `status` 'planned' | 'in_progress' | 'done' | 'dropped', required
  - `notes` string
  - `period` 'Q1' | 'Q2' | 'Q3' | 'Q4' | 'annual', required

## Response `201`

The recorded review

- NetZeroActionReviewResponse
  - `data` NetZeroActionReview, required
    - `changes` NetZeroActionReviewChange[], required
      - `actionId` string, uuid, required
      - `fromStatus` 'planned' | 'in_progress' | 'done' | 'dropped', required
      - `progressNote` string, required
      - `title` string, required — The action's title when the review was recorded.
      - `toStatus` 'planned' | 'in_progress' | 'done' | 'dropped', required
    - `id` string, uuid, required
    - `notes` string, required
    - `period` 'Q1' | 'Q2' | 'Q3' | 'Q4' | 'annual', required
    - `reviewedAt` string, date-time, required
    - `reviewedBy` string, required
    - `reviewedByName` string — The reviewer's display name (else their name) as Greentally knows them; left out when it has neither. Never an email address.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict

## Changes

- **2026-10-04** `77d466d0e73d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greentally/apis/esgai-api/changes/net-zero/action-memos/:year/reviews/post.md)

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/greentally/apis/esgai-api/revisions/77d466d0e73d?raw)