---
title: "Create a Retrospective Review"
method: POST
path: "/retrospectives/{id}/reviews"
tags: ["Retrospectives"]
---

# Create a Retrospective Review

`POST /retrospectives/{id}/reviews`

## Path parameters

- `id` string, required

## Request body

- CreateRetrospectiveReviewRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `attributes` RetrospectiveReviewAttributes, required
    - `comment` ExpandableRetrospectiveCommentAttributes, required
      - `attributes` RetrospectiveCommentAttributes
        - `content` string, required
        - `replies` RetrospectiveComment[], required
          - `attributes` RetrospectiveCommentAttributes, required — recursive
          - `id` string, required
        - `user` User, required
          - `attributes` UserAttributes, required
            - `email` string, required
            - `name` string, required
            - `organizationRole` 'admin' | 'member', required
          - `id` string, required
      - `id` string, required
    - `requester` ExpandableUser, required
      - `attributes` User
        - `attributes` UserAttributes, required
          - `email` string, required
          - `name` string, required
          - `organizationRole` 'admin' | 'member', required
        - `id` string, required
      - `id` string, required
    - `reviewer` ExpandableUser, required
      - `attributes` User
        - `attributes` UserAttributes, required
          - `email` string, required
          - `name` string, required
          - `organizationRole` 'admin' | 'member', required
        - `id` string, required
      - `id` string, required

## Response `200`

OK

- CreateRetrospectiveReviewResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` RetrospectiveReview, required
    - `attributes` RetrospectiveReviewAttributes, required
      - `comment` ExpandableRetrospectiveCommentAttributes, required
        - `attributes` RetrospectiveCommentAttributes
          - `content` string, required
          - `replies` RetrospectiveComment[], required
            - `attributes` RetrospectiveCommentAttributes, required — recursive
            - `id` string, required
          - `user` User, required
            - `attributes` UserAttributes, required
              - …
            - `id` string, required
        - `id` string, required
      - `requester` ExpandableUser, required
        - `attributes` User
          - `attributes` UserAttributes, required
            - `email` string, required
            - `name` string, required
            - `organizationRole` 'admin' | 'member', required
          - `id` string, required
        - `id` string, required
      - `reviewer` ExpandableUser, required
        - `attributes` User
          - `attributes` UserAttributes, required
            - `email` string, required
            - `name` string, required
            - `organizationRole` 'admin' | 'member', required
          - `id` string, required
        - `id` string, required
    - `id` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

## Changes

- **2026-07-29** (v1) `227f4f2711e4` — 3 breaking, 3 info
  - added the new required request property `attributes/comment/attributes/user/attributes/organizationRole`
  - added the new required request property `attributes/requester/attributes/attributes/organizationRole`
  - added the new required request property `attributes/reviewer/attributes/attributes/organizationRole`
  - added the required property `data/attributes/comment/attributes/user/attributes/organizationRole` to the response with the `200` status
  - …2 more

[Change history](https://skmtc.dev/rezible/apis/rezible-api/changes/retrospectives/:id/reviews/post.md)

---

[API](https://skmtc.dev/rezible/apis/rezible-api.md) · [All operations](https://skmtc.dev/rezible/apis/rezible-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rezible/apis/rezible-api/revisions/8f8792ec473d?raw)