---
title: "Configure review settings"
method: PUT
path: "/api/v1/review-settings"
tags: ["reviews"]
---

# Configure review settings

`PUT /api/v1/review-settings`

## Request body

- ConfigureReviewRequest
  - `repo` string, required
  - `autoReview` 'off' | 'once' | 'always'
  - `postingThreshold` 'low' | 'medium' | 'high'
  - `postInvestigate` boolean
  - `postNotes` boolean

## Response `200`

ReviewSettings

- ReviewSettingsEncoded
  - `repo` string, required
  - `billingOrgId` string, nullable, required
  - `heldByCaller` boolean, required
  - `autoReview` 'off' | 'once' | 'always', required
  - `postingThreshold` 'low' | 'medium' | 'high', required
  - `postInvestigate` boolean, required
  - `postNotes` boolean, required

## Other responses

- `401` — capy/Unauthorized
- `403` — capy/Forbidden
- `422` — capy/ReviewRefused

## Changes

- **2026-08-11** `792c11dd1007` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/capy/apis/capy-api/changes/api/v1/review-settings/put.md)

---

[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)