Ack review events (advance cursor)

POST

/v1/reviews/events/ack

• Production
• Local

Advance the agent’s per-(agent, review) cursor(s) to the supplied through_seq and/or mark broadcast nudges done. Idempotent and monotonic; an older seq is a no-op (exactly-once effect, spec §6). Customer-scoped.

Authorizations

• AgentKey
  mailbox:read

Request Body ^required

Advance per-(agent, review) cursors and/or mark broadcast nudges done. Idempotent and monotonic; re-acking an older seq is a no-op (exactly-once effect, spec §6). Either set may be empty.

object

acks

Array<object>

object

review_id

required

string

through_seq

required

integer

broadcast_ids

Array<string>

Responses

200

Ok

object

cursors

required

Array<object>

The agent’s per-(agent, review) ack frontier; its strict-FIFO position for one review.

object

review_id

required

string

last_acked_seq

required

integer

400

Invalid request.

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

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