Hanzo
OpenapiO11y

Lists human annotations on traces and observations, optionally scoped to one…

Lists human annotations on traces and observations, optionally scoped to one review queue.

GET /v1/o11y/llm/annotation

Addresshttps://api.hanzo.ai/v1/o11y/llm/annotation
MethodGET
OperationListLLMAnnotations
AuthAuthorization: Bearer $HANZO_API_KEY

Lists human annotations on traces and observations, optionally scoped to one review queue.

Callers need the viewer role; the runtime's own gate enforces it.

Request

5 fields.

FieldInTypeRequiredDescription
traceIdquerystringTraceID narrows to annotations on one trace.
queuequerystringQueue narrows to one review queue.
statusquerystringStatus narrows to one review status, e.g.
offsetqueryintegerOffset is how many rows to skip, for paging.
limitqueryintegerLimit caps how many rows come back.

Response

StatusBodyMeaning
200o11y.O11yLLMAnnotationsOutok

200 body — 15 fields.

FieldInTypeAlwaysDescription
databodyo11y.O11yLLMAnnotationsPage
data.itemsbodyo11y.O11yLLMAnnotation[]Items are the annotations, newest first.
data.items[].authorbodystringAuthor is who wrote it.
data.items[].contentbodystringContent is the note itself.
data.items[].createdAtbodystring (date-time)CreatedAt is when the annotation was stored.
data.items[].idbodystringID is the annotation's id.
data.items[].observationIdbodystringObservationID is the observation the annotation attaches to, when narrowed.
data.items[].queuebodystringQueue is the review queue the annotation sits in, when queued.
data.items[].statusbodystringStatus is the annotation's review status, e.g.
data.items[].traceIdbodystringTraceID is the trace the annotation attaches to.
data.items[].updatedAtbodystring (date-time)UpdatedAt is when the annotation last changed.
data.limitbodyintegerLimit is the page cap the read ran with.
data.offsetbodyintegerOffset is the row offset this page started at.
data.totalbodyintegerTotal is how many annotations match, across all pages.
statusbodystringStatus is "success".

Failure carries the platform error shape — see Errors.

Examples

hanzo o11y llm annotation get

O11y API · All Hanzo APIs · Interactive reference

How is this guide?

On this page