---
title: "Create a case review"
method: POST
path: "/v1/cases/{id}/reviews"
tags: ["Cases"]
---

# Create a case review

`POST /v1/cases/{id}/reviews`

Create a case review which will update the case status according to the review status.

---

#### See also  
Learn more about [Cases](./cases-guide)

## Path parameters

- `id` string, uuid, required

## Request body

- union
  - CaseReviewApprovedCreate
    - `status` 'approved', required
    - `comment` string — May be **required** depending on your workspace settings
    - `reviewed_at` string, date-time — Optional review date, will default to current time if not set. Useful to anti-date a review Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
    - `next_review_at` string, date, nullable — Computed by default from your workspace settings and the case risk level by default but optionally override the next review date for this case, with `null` to force not date (no next review scheduled). Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
  - CaseReviewRejectedCreate
    - `status` 'rejected', required
    - `comment` string — May be **required** depending on your workspace settings
    - `reviewed_at` string, date-time — Optional review date, will default to current time if not set. Useful to anti-date a review Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - CaseReviewClosedCreate
    - `status` 'closed', required
    - `comment` string — May be **required** depending on your workspace settings
    - `reviewed_at` string, date-time — Optional review date, will default to current time if not set. Useful to anti-date a review Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)

## Response `201`

Case review has been created

**ℹ️ Click to see full payload**

- CaseReview
  - `id` string, uuid, required
  - `status` 'approved' | 'rejected' | 'closed', required
  - `comment` string, nullable, required
  - `reviewer_type` 'user' | 'system' | 'api', required
  - `user` NestedUser, required
    - `id` string, uuid, required
    - `first_name` string, required
    - `last_name` string, required
    - `email` string, email, required
  - `reviewed_at` string, date-time, required — Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `next_review_at` string, date, nullable, required — Next review date. `null` if no review schedule after this one. Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)

## Other responses

- `400` — The request is either malformed or contain invalid parameters. - Make sure the body payload matches the expected schema
- `404` — No case can be found.

---

[API](https://skmtc.dev/dotfile/apis/api-specifications.md) · [All operations](https://skmtc.dev/dotfile/apis/api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dotfile/api-specifications/revisions/36393567057b/schema)