Get one review request (current draft + intent + state)

GET

/v1/reviews/{id}

• Production
• Local

Authorizations

• AgentKey
  mailbox:read

Parameters

Path Parameters

id

required

string

Responses

200

Ok

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

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