---
title: "Update an existing review."
method: PUT
path: "/authoring/v1/review/{id}"
tags: ["Authoring review"]
---

# Update an existing review.

`PUT /authoring/v1/review/{id}`

Use the /review/{id} end point to update an existing review that matches the ID that is specified.
<br />User roles: admin, manager, editor

## Path parameters

- `id` string, required

## Request body

- object
  - `rev` string, required — The current revision of the document.
  - `name` string, required — The name of the review.
  - `targetDate` string, date-time — Optional. Set a target date for when the review is due and must end.
  - `approvers` object[] — Approvers' user ID for the review.
    - `id` string

## Response `200`

Successfully updated the review that matches the ID that you provided.

- object
  - `id` string, required — The ID of the review.
  - `rev` string, required — The current revision of the review.
  - `classification` string — The review's classification.
  - `name` string, required — The name of the review.
  - `targetDate` string, date-time — Optional. Set a target date for when the review is due and must end.
  - `status` 'active' | 'complete' — The status of a review. The initial status of a review is active, changed to complete when it is ended.
  - `approvalStatus` 'approved' | 'not-approved' — The approval status of a review. The initial status of a review is not-approved, changed to approved when all items has been approved.
  - `completed` string, date-time — The completed date of this review in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
  - `approvers` object[] — Approvers' user ID for the review.
    - `id` string
  - `approvals` object[] — Approvals for a review.
    - `user` object — A user object with user ID.
      - `id` string
    - `date` string, date-time — The approved date in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
    - `items` object[] — The ID of the items that been approved in a approval.
      - `id` string
      - `classification` 'asset' | 'content' — The classification of the item.
  - `rejections` object[] — Rejections for a review.
    - `user` object — A user object with user ID.
      - `id` string
    - `date` string, date-time — The approved date in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
    - `items` object[] — The ID of the items that been rejected in a rejection.
      - `id` string
      - `classification` 'asset' | 'content' — The classification of the item.
  - `items` object[] — Provide the ID of the items that you want to submit for review. The unique ID (uid) is the items classification and the ID combined to create an ID that is unique across all content hub items.
    - `id` string
    - `classification` 'asset' | 'content' — The classification of the item.
  - `lastModified` string, date-time — The last modified date of this review in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
  - `lastModifierId` string — The ID of the user that last modified the review.
  - `created` string, date-time — The created date of this review in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ.
  - `creatorId` string — The ID of the creator of the review.

## Other responses

- `400` — The update request is invalid or the request failed validation. Provide valid values and try again.
- `404` — The review with ID {id} was not found.
- `409` — Unable to update the review with the ID "{0}" because another user updated the review since it was last retrieved. Retrieve the review again and reapply your changes.
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
- `503` — Unable to retrieve the review from the database as the service is unavailable. Try again later.
- `default` — Unexpected error.

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/versions/677305266d89/schema)