Hanzo
OpenapiEvent

Errors returns the caller org's most recently captured errors, newest first.

Errors returns the caller org's most recently captured errors, newest first.

GET /v1/event/errors

Addresshttps://api.hanzo.ai/v1/event/errors
MethodGET
Operationget_event_errors
AuthAuthorization: Bearer $HANZO_API_KEY

Errors returns the caller org's most recently captured errors, newest first. The error-tracking read view over event.error — the plane table the write core's error facts land in (errors are DELIBERATELY not on event.event) — each with its captured exception surfaced from the attributes map as a first-class field.

The org is the validated principal's — never a parameter — and this read requires a real bearer, NEVER the write-only publishable key: pk- can attribute a write and can read nothing. 403 without a validated bearer, 503 when the warehouse is unreachable.

Request

1 field.

FieldInTypeRequiredDescription
limitqueryintegerLimit is how many rows to return, newest first.

Response

StatusBodyMeaning
200errorListok

200 body — 13 fields.

FieldInTypeAlwaysDescription
databodycapturedError[]Data is the errors, newest first.
data[].distinctIdbodystringDistinctID is the person/visitor the error is attributed to.
data[].eventbodystringEvent is the event name the error was stored under, e.g.
data[].exceptionbodyanyException is the captured error itself — the {type, message, stack, handled} object, already redacted at the fold point.
data[].idbodystringID is the row's stable event id — the client's own idempotency id when it sent one, else the server-minted one.
data[].librarybodystringLibrary is the client SDK that reported the error.
data[].libraryVersionbodystringLibraryVer is that SDK's version.
data[].pathbodystringPath is the URL's path component.
data[].productbodystringProduct is the surface that emitted the error.
data[].propertiesbodyanyProperties is the row's whole property bag, returned verbatim as stored — any JSON object, $exception included.
data[].sessionIdbodystringSessionID groups the events of one visit.
data[].timestampbodystringTimestamp is when the error was captured, RFC3339 UTC.
data[].urlbodystringURL is the full page address the error fired on.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


Event API · All Hanzo APIs · Interactive reference

How is this guide?

On this page