Export the inspector's file for a range of dates

box.inspection.export

Writes the evidence file a regulator's inspector asks for, hyperscale.evidence.v2 with a box subject, that `hyperscale inspect verify` checks offline against the instance public key in the box's /release.json. Its records, each stored once by SHA-256 under a manifest the Assure key signs and the instance key endorses: the Core register, every version of every Product saved before the range ends, with its number, the gate signatures on its digest, the diff from the version before and, for a live Core, its promotion; the releases Arc started serving on the box; every approval decided in the range with the member behind each decision; every month closed in the range, its close record whose bytes hash to the close's digest and the manifestDigest of each file taken from it; every alert firing and clearing; the ops/events.jsonl lines the installer and `hyperscale keys rotate` wrote in the range, a key named by name and time only; ops/drill-status/last.json, the restore drill's last run; the range's audit events in chain order between the chain heads the instance stores; and every access event in the range, each email and credential by fingerprint. `redacted: true` leaves out each audit event's body and each access event's client address and host. A range that ends at or before it starts refuses with inspection_range_empty. The audit row box.inspection.exported names you, the range and the file's manifestDigest. Callers: the account owner's own CLI login (`hyperscale auth login`), or a personal access token with activity:read. An agent token is refused.

POST /v1/box-inspections/evidence

Principal user_session. Idempotency required. Environment either.

Input

Output

Request sample

Only a signed-in person may call this: the founder's own CLI after hyperscale auth login, or curl with a personal access token (hyperscale_pat_...) with activity:read. A Product key cannot, so the SDK, which signs in with a Product key or a customer session, has no sample for it.

curl

curl --request POST 'https://hyperscale0.ai/v1/box-inspections/evidence' \
  --header "Authorization: Bearer $HYPERSCALE_TOKEN" \
  --header 'X-Hyperscale-Environment: sandbox' \
  --header "Idempotency-Key: $(uuidgen)" \
  --header 'Content-Type: application/json' \
  --data-raw '{"tenantId":"ten_sandbox_example0001","from":"2026-01-01","to":"2026-02-01"}'

CLI

hyperscale api call box.inspection.export \
  --input '{"tenantId":"ten_sandbox_example0001","from":"2026-01-01","to":"2026-02-01"}'

Errors

All operations