Skip to main content
PUT
/
api
/
v1
/
runs
/
{id}
/
reviews
Update run review
curl --request PUT \
  --url https://studio.eigenpal.com/api/v1/runs/{id}/reviews \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "note": "<string>",
  "correctedOutput": "<unknown>",
  "corrections": [
    {
      "path": "<string>",
      "id": "<string>",
      "label": "<string>",
      "originalValue": "<unknown>",
      "correctedValue": "<unknown>",
      "note": "<string>",
      "correctedArtifactPath": "<string>"
    }
  ]
}
'
{
  "review": {
    "id": "<string>",
    "note": "<string>",
    "reviewedBy": "<string>",
    "reviewedByEmail": "<string>",
    "reviewedAt": "<string>",
    "closedBy": "<string>",
    "closedByEmail": "<string>",
    "closedAt": "<string>",
    "closedNote": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "corrections": [
      {
        "id": "<string>",
        "path": "<string>",
        "label": "<string>",
        "note": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "originalValue": null,
        "correctedValue": null,
        "correctedArtifactPath": "<string>"
      }
    ],
    "correctedOutput": null
  }
}

Authorizations

​
Authorization
string
header
required

API key issued from Settings → API Keys. Pass as Authorization: Bearer <key>.

Path Parameters

​
id
string
required

Run id.

Body

application/json

Create or replace review metadata for a run. Attribution fields (reviewedBy, closedBy, and their emails) are read-only and populated from the authenticated user or API key creator.

​
verdict
enum<string> | null

Reviewer verdict. Omit or send null for feedback without a ranking (nit). Defaults are applied client-side only; any verdict/status combination is accepted.

Available options:
correct,
incorrect
​
status
enum<string>

Review lifecycle. Defaults from verdict (correct → closed, otherwise open). Use closed or wont_fix to close an open review.

Available options:
open,
closed,
wont_fix
​
note
string | null

Reviewer note.

​
correctedOutput
any | null

Corrected JSON output for this run. Send null to clear a previously stored correction.

​
corrections
object[]

Field and file corrections. When present, replaces the entire correction set for this review. Omit to leave existing corrections unchanged.

Response

Updated run review metadata.

​
review
object
required

Review metadata and corrections. Corrected files are listed separately at GET /runs/{id}/reviews/expected.