Reviews

Trigger and inspect deterministic reviews on pull requests.

The Reviews resource lets you trigger a deterministic review on any pull request and read its verdict, signals, and audit chain.

Try it out

POST/v1/reviews

Request body

No fields.

Response

—

// Click "Send request" to see a sample response

Endpoint

POST /v1/reviews
Authorization: Bearer <token>
Content-Type: application/json

Request body

Field	Type	Required	Description
`repo`	string	yes	`<owner>/<name>`
`pr`	integer	yes	Pull request number
`ticket`	string	no	Ticket id (e.g. `PRX-42`)
`policy`	string	no	Override the default tenant policy
`dry_run`	boolean	no	Do everything except persist the verdict

Successful response

{
  "id": "rev_01HXYZ4P9N",
  "status": "queued",
  "verdict": null,
  "tier": null,
  "trace_url": null,
  "created_at": "2026-04-24T11:42:09Z"
}

The verdict is computed asynchronously. Subscribe to the review.completed webhook or poll GET /v1/reviews/{id} for the final result.

Final shape

Once the pipeline completes, the same resource looks like:

{
  "id": "rev_01HXYZ4P9N",
  "status": "complete",
  "verdict": "auto-approve",
  "tier": "T2",
  "confidence": 0.94,
  "ac_bindings": [
    { "id": "AC1", "lines": ["email.py:34-35"], "confidence": 0.97 },
    { "id": "AC2", "lines": ["email.py:52"], "confidence": 0.91 }
  ],
  "trace_url": "https://app.codingassist.bot/traces/rev_01HXYZ4P9N",
  "completed_at": "2026-04-24T11:42:12Z"
}

Errors

Code	Meaning
`E_AC_001`	Ticket has no acceptance criteria — see E_AC_001
`E_TOK_002`	Provider token decryption failed — see E_TOK_002
`400`	Invalid `repo` or `pr`
`401`	Missing or invalid `Authorization` header
`429`	Tenant rate limit hit

← Previous

Authentication

Findings

Was this page helpful?