Get one review (intent + current draft + turns + diff)

GET

/v1/admin/orgs/{org_id}/projects/{project_id}/reviews/{id}

• Production
• Local

The full review for the console detail view: intent, the current draft (subject/body), the append-only thread turns, and the diff if the draft was revised. Customer-scoped; a foreign id is 404 (no cross-tenant leak).

Authorizations

• ClerkSession

Parameters

Path Parameters

org_id

required

string

project_id

required

string

id

required

string

Responses

200

Ok

Full console review detail (console plane): the review (intent + current draft + diff if revised) plus the append-only thread turns.

object

review

required

A review request (rr_…); the server-owned pre-send record of a message under the Review Loop. Carries intent, the current proposed draft, category, state machine fields, and (once sent) the sent body + diff.

object

id

required

string

state

required

string

Allowed values: needs_review in_review chatting stale approved sent auto_sent rejected stalled cancelled failed

mode

required

string

Allowed values: review direct

effective_mode

required

string

Allowed values: review direct

kind

required

string

Allowed values: send reply forward

from_address

string

agent_id

string

category_id

string

intent_summary

string

intent_meta

object

key

additional properties

any

revision

required

integer

version

required

integer

proposed_subject

string

proposed_body_text

string

proposed_body_html

string

proposed_to

Array<string>

proposed_cc

Array<string>

proposed_bcc

Array<string>

sent_subject

string

sent_body_text

string

diff_unified

string

sent_message_id

string

gate_outcome

string

stale_reason

string

decision_feedback

string

closed

True once this review will never move again; sent, auto_sent, cancelled OR failed. It is the definitive per-review “am I done?” answer and the poll-side companion to the terminal review events; use it after a restart when your event cursor is gone. failed is included deliberately: nothing re-approves a failed review, so treating it as open means waiting forever.

boolean

send_error

Vendor-scrubbed delivery failure, present on a failed review.

string

send_path

How the message was released, once sent.

string

Allowed values: human_reviewed reviewer_approved graduated_auto agent_direct

created_at

string format: date-time

updated_at

string format: date-time

decided_at

string format: date-time

sent_at

string format: date-time

turns

required

Array<object>

One immutable turn in a review’s append-only thread (turn_…).

object

id

required

string

seq

required

integer

turn_type

required

string

Allowed values: agent_draft agent_question agent_note human_comment human_question human_edit human_approve human_reject human_reconfirm system_diff state_change nudge

actor_kind

required

string

Allowed values: agent human review_agent system

actor_id

string

body

string

revision

integer

diff_json

object

key

additional properties

any

metadata

object

key

additional properties

any

created_at

required

string format: date-time

401

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

403

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

404

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