---
title: "Create a review"
method: POST
path: "/v1/workspaces/{workspaceId}/reviews"
tags: ["Reviews"]
---

# Create a review

`POST /v1/workspaces/{workspaceId}/reviews`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/reviews`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, uuid, required

## Request body

- CreateReviewDto
  - `items` ReviewItemInputDto[], required
    - `contentId` string, uuid, required
  - `stages` ReviewStageInputDto[], required
    - `id` string, uuid, nullable
    - `kind` 'team' | 'client', required
    - `rule` 'any' | 'all', required
    - `inOrder` boolean, nullable
    - `deadlineDays` integer, nullable, required
    - `participants` ReviewParticipantInputDto[], required
      - `id` string, uuid, nullable
      - `userId` string, uuid, nullable
      - `name` string, nullable
      - `email` string, email, nullable
  - `label` string, nullable
  - `expiresAt` string, nullable
  - `inviteNote` string, nullable
  - `workflowId` string, uuid, nullable
  - `sendNow` boolean, nullable

## Response `201`

Review created

- object
  - `data` PublicReviewCreatedDto, required
    - `reviewId` string, uuid, required
  - `meta` unknown, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)