> ## Documentation Index
> Fetch the complete documentation index at: https://docs.app.strix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# PR Reviews

> Trigger and inspect automated pull request security reviews

export const ScarfPixel = () => <img referrerPolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=831669b6-b4bd-42cb-8832-2122c03e1d5f" alt="" width="1" height="1" style={{
  position: "absolute",
  width: 0,
  height: 0,
  opacity: 0,
  pointerEvents: "none"
}} />;

<ScarfPixel />

PR reviews run Strix against a specific pull request and surface findings inline.

## List PR reviews

```bash theme={null}
curl -X GET "https://app.strix.ai/api/v1/pr-reviews?limit=20" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
```

**Required scope:** `pr_reviews:read`

## Get a PR review

```bash theme={null}
curl -X GET "https://app.strix.ai/api/v1/pr-reviews/<PR_REVIEW_ID>" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
```

**Required scope:** `pr_reviews:read`

## Start a PR review

Trigger a review for a pull request by repository full name and PR number:

```bash theme={null}
curl -X POST "https://app.strix.ai/api/v1/pr-reviews/start" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "repository_full_name": "my-org/my-repo",
    "pr_number": 42
  }'
```

**Required scope:** `pr_reviews:write`

## PR review settings

Read the org's PR review configuration:

```bash theme={null}
curl -X GET "https://app.strix.ai/api/v1/pr-reviews/settings" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
```

**Required scope:** `pr_reviews:read`

Update the configuration. All fields are required:

```bash theme={null}
curl -X PATCH "https://app.strix.ai/api/v1/pr-reviews/settings" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "exclude_bots": true,
    "excluded_authors": ["dependabot"],
    "reviewed_bots": [],
    "review_on_push": true,
    "allow_overage": false,
    "overage_review_cap": null
  }'
```

**Required scope:** `pr_reviews:write`