HumanReviewed docs

Review requests

Create a pending request for a human to review an artefact.

POST/v1/attestation-requests

Body:

FieldTypeNotes
artefactHashbytes320x SHA-256 of the canonical artefact JSON (or omit and hash client-side via the SDK)
agentIdstringNamespaced, e.g. agent.acme.example/claims
agentRunIdstringIdempotency key with the hash + owner
reviewScopestringRole of the review, e.g. editorial
signerIdentityUidbytes32The expected reviewer’s identity
requiredTierint?Minimum signer tier (0–3)
clauseIdstring?Compliance pack clause to issue under
callbackUrlstring?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.

json
{
  "attestation": { "uid": "0x…", "reviewKindSlug": "reviewed", "signerTierSlug": "org_attested", … },
  "permalink": "https://humanreviewed.org/0x…",
  "badgeUrl": "https://humanreviewed.org/api/badge/0x….svg"
}