Review requests
Create a pending request for a human to review an artefact.
POST/v1/attestation-requests
Body:
| Field | Type | Notes |
|---|---|---|
artefactHash | bytes32 | 0x SHA-256 of the canonical artefact JSON (or omit and hash client-side via the SDK) |
agentId | string | Namespaced, e.g. agent.acme.example/claims |
agentRunId | string | Idempotency key with the hash + owner |
reviewScope | string | Role of the review, e.g. editorial |
signerIdentityUid | bytes32 | The expected reviewer’s identity |
requiredTier | int? | Minimum signer tier (0–3) |
clauseId | string? | Compliance pack clause to issue under |
callbackUrl | string? | Receives the attestation when signed |
Compliance packs adjust the response
When a pack is active, the returned request carries the governing clause’s
policyUri and a possibly raised requiredTier. See Compliance packs.Fetch a request
GET/v1/attestation-requests/{id}
Public. Returns the request with its status (pending / issued) and, once signed, resolvedAttestationUid.
Submit a decision (issues the attestation)
POST/v1/attestation-requests/{id}/submit
Called by the hosted signer app when a human signs, not by autonomous agents. Body: reviewKind (0 glance, 1 reviewed, 2 revised, 3 endorsed, 4 rejected), signerIdentityUid, optional signerRole. Enforces the signer match, the required tier, active compliance clauses, then the billing gate. Returns the issued attestation plus its permalink and badgeUrl.
{
"attestation": { "uid": "0x…", "reviewKindSlug": "reviewed", "signerTierSlug": "org_attested", … },
"permalink": "https://humanreviewed.org/0x…",
"badgeUrl": "https://humanreviewed.org/api/badge/0x….svg"
}