Hanzo
API Reference

Hanzo Eval API

Native, org-scoped LLM evaluation surface (hanzoai/cloud → clients/eval).

Native, org-scoped LLM evaluation surface (hanzoai/cloud → clients/eval).

Hanzo Eval API · All API references →

Base URLhttps://api.hanzo.ai
Version1.0.0
Operations16

Authentication

  • BearerAuth — HTTP bearer

All Hanzo APIs share one bearer credential and common error and pagination conventions. See API conventions.

curl -H "Authorization: Bearer $HANZO_API_KEY" https://api.hanzo.ai

Endpoints

Datasets

MethodEndpointDescription
GET/v1/evals/datasetsList the org's datasets
POST/v1/evals/datasetsCreate or upsert a dataset
GET/v1/evals/datasets/{name}Get a dataset with its active item count
DELETE/v1/evals/datasets/{name}Delete a dataset and its items
GET/v1/evals/dataset-itemsList items in a dataset
POST/v1/evals/dataset-itemsCreate or upsert a dataset item

Evaluators

MethodEndpointDescription
GET/v1/evals/evaluatorsList the org's evaluators
POST/v1/evals/evaluatorsCreate or upsert an evaluator

Observations

MethodEndpointDescription
GET/v1/evals/observationsList production LLM generations

Runs

MethodEndpointDescription
GET/v1/evals/runsList run records
POST/v1/evals/runsRun a dataset through a model and an LLM judge

Score Configs

MethodEndpointDescription
GET/v1/evals/score-configsList the org's score configs
POST/v1/evals/score-configsCreate or upsert a score config

Scores

MethodEndpointDescription
GET/v1/evals/scoresList score events
POST/v1/evals/scoresRecord a score event

Traces

MethodEndpointDescription
GET/v1/evals/tracesList traces

All Hanzo APIs · OpenAPI spec

How is this guide?

On this page