---
title: "Start review"
method: POST
path: "/api/v1/reviews"
tags: ["reviews"]
---

# Start review

`POST /api/v1/reviews`

## Request body

- StartReviewRequest
  - `repo` string, required
  - `prNumber` integer, required
  - `idempotencyKey` string
  - `forceRefresh` boolean
  - `sourceThreadId` string
  - `model` string
  - `effort` 'none' | 'instant' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max'

## Response `200`

ReviewStarted

- ReviewStartedEncoded
  - `reviewId` string, required
  - `requestId` string, required
  - `threadId` string, required
  - `headSha` string, required
  - `adopted` boolean, required
  - `sourceRecorded` boolean

## Other responses

- `401` — capy/Unauthorized
- `402` — capy/PaidFeatureUnavailable
- `422` — capy/ReviewRefused

---

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