---
title: "Create Review"
method: POST
path: "/v1/contracts/{contract_id}/reviews"
tags: ["contracts"]
---

# Create Review

`POST /v1/contracts/{contract_id}/reviews`

## Request

- Base URL: `https://api.actuato.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.actuato.com/v1/contracts/{contract_id}/reviews`
- Auth: none declared

## Path parameters

- `contract_id` string, uuid, required

## Request body

- ReviewCreate
  - `rating` integer, required
  - `dimensions` object, nullable: Worker: quality, punctuality, communication, value. Principal: clarity, access, payment.
  - `body` string, nullable
  - `would_work_again` boolean, nullable: Would you work with this person again? Kept private. When both sides say yes, each sees the other as a match and hears about the other's jobs first.

## Response `201`

Successful Response

- ReviewOut
  - `id` string, uuid, required
  - `contract_id` string, uuid, required
  - `reviewer_user_id` string, uuid, required
  - `reviewee_user_id` string, uuid, required
  - `direction` 'principal_to_worker' | 'worker_to_principal', required
  - `rating` integer, required
  - `dimensions` object, nullable, required
  - `body` string, nullable, required
  - `published_at` string, date-time, nullable, required
  - `response_body` string, nullable, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/actuato/apis/actuator-api.md) · [All operations](https://skmtc.dev/actuato/apis/actuator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/actuato/apis/actuator-api/revisions/67a742c2308b?raw)