Skip to content

Get the human's assembled feedback for a review (diff + comments + decision + new rules)

GET
/v1/reviews/{id}/feedback

Assemble the human’s feedback for a review (M5; spec §5.2/§11): the unified + structured diff of the human edit, the human comments / rejection feedback, the decision, and the rules born from this review (rule_ ids whose source_review_id is this review). Read-only; tenant-scoped (a foreign id 404s). $0 LLM; pure assembly over already-stored turns + rules.

id
required
string

Ok

The human’s assembled feedback for a review (spec §11): the unified + structured diff of the human’s edit, the human comments/rejection feedback, the decision, and the rules born from this review (rule_ ids whose source_review_id is this review). Read-only; $0 LLM (pure assembly over stored turns/rules).

object
review_id
required
string
decision
required

Edited | approved | rejected | .

string
diff_unified
string
diff_json
object
key
additional properties
any
comments
required
Array<object>

One human/agent comment in the assembled review feedback (spec §11).

object
turn_id
required
string
actor_kind
required
string
Allowed values: agent human review_agent system
actor_id
string
body
required
string
created_at
required
string format: date-time
new_rules
required

Rule_ ids whose provenance points at this review (M4 source_review_id).

Array<string>

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

Authenticated but lacking the required scope, or out of quota.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope

Resource not found.

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope