System

Audit trail diagnostic export

Evidence-preserving export in file order, paged by byte offset. Remains available when sequence-based export refuses an ambiguous cursor. Returns line digests and offsets without raw record bytes. Free at every tier; requires system:control scope.

get/v1/audit/tools/diagnostic

Request

  • Base URL: http://localhost:9998
  • URL: http://localhost:9998/v1/audit/tools/diagnostic
  • Auth: HTTP bearer

Query parameters

frominteger

Byte offset to start reading; malformed values default to 0 and negative values clamp to 0.

limitinteger

Maximum lines; clamped to 1–5000.

Response

Diagnostic page in file order

trailIdstring required
nextByteOffsetinteger nullable

Next byte offset; absent or null at end of file.

limitinteger required
contentDigeststring

SHA-256 over the WHOLE records file, not this page. The content provenance a rotation must name.

byteCountinteger

Length of the whole records file in bytes.

Changes

No recorded changes to this operation across all 1 revision of this API.