Agent Review Overview

The Agent Review API exposes the reference data an AI document-review agent evaluates against and reports with. It is read-only.

Key Concepts

Reason codes

A fixed taxonomy, versioned by taxonomyVersion, in three categories:

• ESCALATION — required on a ROUTE_TO_COMPLIANCE finding
• REPLACEMENT — required on a REQUEST_REPLACEMENT finding
• OVERRIDE — staff-only; reaches agents as overrideReasonCode on requirement.satisfied

Codes are stable strings (ESC_UNREADABLE_ITEM), never UUIDs. Some require an explanation on the finding.

Review criteria

One row per document type, versioned. Each row carries the ordered rules an agent applies — what to check, how, and what a failure produces (onFail). The row that applies to a requirement slot is referenced by criteria on the slot; cache bodies by (criteriaId, version).

Available Endpoints