Hanzo
OpenapiO11y

Attaches an eval score or human-feedback signal to a trace or a single…

Attaches an eval score or human-feedback signal to a trace or a single observation.

POST /v1/o11y/llm/scores

Addresshttps://api.hanzo.ai/v1/o11y/llm/scores
MethodPOST
OperationCreateLLMScore
AuthAuthorization: Bearer $HANZO_API_KEY

Attaches an eval score or human-feedback signal to a trace or a single observation.

Callers need the editor role; the runtime's own gate enforces it, and it validates the payload and stamps the score's author and org.

Request

8 fields, body application/json (required).

FieldInTypeRequiredDescription
commentbodystringComment is a free-text note.
dataTypebodystringDataType is the score's kind — NUMERIC or CATEGORICAL.
namebodystringName is the score's name, e.g.
observationIdbodystringObservationID is the single observation the score attaches to, when narrowed to one.
sourcebodystringSource is where the score came from, e.g.
stringValuebodystringStringValue is the categorical score, when the score is categorical.
traceIdbodystringTraceID is the trace the score attaches to.
valuebodynumberValue is the numeric score.

Response

StatusBodyMeaning
201o11y.O11yLLMScoreOutcreated

201 body — 15 fields.

FieldInTypeAlwaysDescription
databodyo11y.O11yLLMScore
data.commentbodystringComment is a free-text note.
data.createdAtbodystring (date-time)CreatedAt is when the score was stored.
data.createdBybodystringCreatedBy is who created the score.
data.dataTypebodystringDataType is the score's kind — NUMERIC or CATEGORICAL.
data.idbodystringID is the score's id.
data.namebodystringName is the score's name.
data.observationIdbodystringObservationID is the observation the score attaches to, when narrowed.
data.sourcebodystringSource is where the score came from, e.g.
data.stringValuebodystringStringValue is the categorical score, when the score is categorical.
data.timestampbodystring (date-time)Timestamp is the score's own event time.
data.traceIdbodystringTraceID is the trace the score attaches to.
data.updatedAtbodystring (date-time)UpdatedAt is when the score last changed.
data.valuebodynumberValue is the numeric score.
statusbodystringStatus is "success".

Failure carries the platform error shape — see Errors.

Examples

hanzo o11y llm scores create

O11y API · All Hanzo APIs · Interactive reference

How is this guide?

On this page