Runs

Record a review decision on a run

Approve/reject/pend a run. With promote: true on an approval, the run's candidate snapshots become new hosted baseline versions. Reviews made with an agent token are attributed to the agent ("<label> (agent, on behalf of <owner>)"). Requires the reviews:write scope on agent tokens; promote: true additionally requires baselines:write (promotion writes to the baseline source of truth), so Triage-scoped tokens can review but not promote.

post/api/v1/runs/{id}/review

Request

  • Base URL: https://dungbeetle.dev
  • URL: https://dungbeetle.dev/api/v1/runs/{id}/review
  • Auth: one of:
    • HTTP basic
    • HTTP bearer

Path parameters

idstring required

Run id.

Request body

state'pending' | 'approved' | 'rejected' required
notestring
promoteboolean

Only honored when state is approved. Agent tokens must also hold the baselines:write scope.

Response

Review recorded.

Changes

No recorded changes to this operation across all 1 revision of this API.