---
title: "Start a review by repository and Trail number"
method: POST
path: "/api/v1/trails/{forge}/{owner}/{repo}/{number}/reviews"
tags: ["CodeReview"]
---

# Start a review by repository and Trail number

`POST /api/v1/trails/{forge}/{owner}/{repo}/{number}/reviews`

## Request

- Base URL: `https://entire.io` (the document declares no server; this is the origin it was published from)
- URL: `https://entire.io/api/v1/trails/{forge}/{owner}/{repo}/{number}/reviews`
- Auth: none declared

## Path parameters

- `forge` string, required
- `owner` string, required
- `repo` string, required
- `number` string, required

## Request body

- object: Native entire-api review request.
  - `headSha` string, nullable
  - `baseSha` string, nullable
  - `baseRef` string, nullable
  - `headRef` string, nullable

## Response `201`

Review started

- object
  - `reviewId` string, required
  - `trailId` string, required
  - `repositoryId` string, required
  - `codeVersionId` string, required
  - `baseSha` string, nullable, required
  - `headSha` string, nullable, required
  - `eventStreamUrl` string, required
  - `diffUrl` string, required
  - `filesUrl` string, required
  - `limits` object, required
    - `maxCommentsPerBatch` number, required

---

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