---
title: "Update a Knowledge Brain evaluation ledger entry."
method: PATCH
path: "/api/v1/brain/review/evaluations"
tags: ["Knowledge Brain"]
---

# Update a Knowledge Brain evaluation ledger entry.

`PATCH /api/v1/brain/review/evaluations`

## Request

- Base URL: `https://commentary.dev`
- URL: `https://commentary.dev/api/v1/brain/review/evaluations`
- Auth: HTTP bearer

## Headers

- `X-Commentary-Workspace-Id` string
- `X-Correlation-Id` string

## Request body

- BrainEvaluationRequest
  - `provider` 'github'
  - `owner` string
  - `repo` string
  - `prNumber` integer, nullable
  - `branchRef` string, nullable
  - `rootFolder` string, nullable
  - `id` string, nullable
  - `question` string, nullable
  - `expectedAnswer` string, nullable
  - `expectedSourcePages` unknown
  - `actualAnswer` string, nullable
  - `retrievedPages` unknown
  - `grade` unknown
  - `reviewerNotes` string, nullable

## Response `200`

Successful response.

- object
  - `ok` unknown
  - `evaluation` BrainEvaluation

## Other responses

- `400`: The request was invalid.
- `401`: Authentication is required.
- `403`: The token or session does not have permission for this resource.
- `404`: The resource was not found.
- `429`: The request was rate limited.

---

[API](https://skmtc.dev/commentary/apis/commentary-public-api.md) · [All operations](https://skmtc.dev/commentary/apis/commentary-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/commentary/apis/commentary-public-api/revisions/7aaafc198c52?raw)