Traces

Five endpoints for grouping events, documents, and AI attestations into traces, sealing them, and retrieving verifiable proof bundles.

POST/tracesCreate trace

Creates a new trace, a container for grouping related events, documents, and AI attestations into an auditable sequence. Items added to an open trace are included when the trace is sealed. A trace can carry an optional metadata object (max 16 KB).

POST /traces
Authorization: Bearer invoance_live_xxx
Idempotency-Key: <uuid>
Content-Type: application/json

{
  "label":    "Monthly compliance review, March 2026",
  "metadata": { "reviewer": "risk_committee" }
}

GET/tracesList traces

Returns a paginated list of traces for the authenticated tenant. Supports filtering by status (open, sealing, sealed), date range, and whether the trace contains events. Maximum 100 results per page.

GET /traces?page=1&limit=25&status=sealed
Authorization: Bearer invoance_live_xxx

GET/traces/:trace_idRetrieve trace

Returns a trace record including its current status, all linked events, and seal metadata if sealed. Read-only. Requires the read scope.

GET /traces/trc_01HX…
Authorization: Bearer invoance_live_xxx

POST/traces/:trace_id/sealSeal trace

Initiates sealing of an open trace. Computes a composite hash over all linked events, signs the bundle, and transitions the trace to sealed. Returns 202 Accepted, poll the trace endpoint for completion. A sealed trace is immutable.

POST /traces/trc_01HX…/seal
Authorization: Bearer invoance_live_xxx

GET/traces/:trace_id/proofGet trace proof bundle

Returns the full cryptographic proof bundle for a sealed trace, all events with their payloads, hashes, signatures, and the composite hash. Verifiable independently. Only available for sealed traces.

GET /traces/trc_01HX…/proof
Authorization: Bearer invoance_live_xxx

POST /traces Authorization: Bearer invoance_live_xxx Idempotency-Key: <uuid> Content-Type: application/json { "label": "Monthly compliance review, March 2026", "metadata": { "reviewer": "risk_committee" } }