---
title: "Trigger Devin Review"
method: POST
path: "/v3/organizations/{org_id}/pr-reviews"
tags: ["pr-reviews"]
---

# Trigger Devin Review

`POST /v3/organizations/{org_id}/pr-reviews`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/devinenterprise/apis/devin-api-v1/docs/v3/organizations/:org_id/pr-reviews/post.ts> (a function with typed inputs; its response is checked against the schema)

Trigger a Devin Review for a pull/merge request.

Creates a database record that will be picked up by the review
worker pool. Always fetches the latest commit from the PR.

## Path parameters

- `org_id` string, required

## Request body

- PrReviewCreateRequest
  - `pr_url` string, required: Full URL of the pull/merge request to review (e.g. `https://github.com/owner/repo/pull/123`).

## Response `200`

Successful Response

- PrReviewResponse
  - `commit_sha` string, required: Commit SHA of the PR head that will be reviewed.
  - `created_at` string, date-time, required: When the review was accepted.
  - `pr_number` integer, required: Pull/merge request number.
  - `repo_path` string, required: Normalized host-prefixed repo path (e.g. `github.com/owner/repo`).
  - `status` 'pending' | 'running' | 'completed' | 'errored' | 'cancelled', required: Current review status. Newly accepted reviews start as `pending`.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Content
- `429`: Too Many Requests

---

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