Hanzo
OpenapiBenchmark

Validates a router blend — its name, its arms, the rank they escalate through…

Validates a router blend — its name, its arms, the rank they escalate through and the panel fan-out width — and answers 202 with the preset and the…

POST /v1/benchmark/presets

Addresshttps://api.hanzo.ai/v1/benchmark/presets
MethodPOST
Operationpost_benchmark_presets
AuthAuthorization: Bearer $HANZO_API_KEY

Validates a router blend — its name, its arms, the rank they escalate through and the panel fan-out width — and answers 202 with the preset and the enso-<name> it would be served as.

It VALIDATES AND ECHOES: the definition is not persisted yet, so a preset accepted here is not one the model layer will resolve. Treat the response as a check on the blend, not a promise to serve it.

Defaults fill the shape rather than refusing it: an omitted rank becomes the arms in declared order and a panel below 1 becomes 1. The one real invariant is that rank may only name arms the blend declares — the same rule the model catalog enforces — and a rank naming anything else is a 422 listing exactly which entries were undeclared. A blend with no name or no arms is a 400.

Request

6 fields, body application/json (required).

FieldInTypeRequiredDescription
armsbodystring[]the blend — model ids from the arena
namebodystringserved as enso-<name>
notebodystringwhy this blend (audit)
ownerbodystringscoping org (never cross-tenant)
panelbodyintegerfan-out width (>=1)
rankbodystring[]escalation order over arms

Response

StatusBodyMeaning
202presetAcceptedaccepted

202 body — 10 fields.

FieldInTypeAlwaysDescription
notebodystringNote explains what acceptance does and does not promise.
presetbodyPreset
preset.armsbodystring[]the blend — model ids from the arena
preset.namebodystringserved as enso-<name>
preset.notebodystringwhy this blend (audit)
preset.ownerbodystringscoping org (never cross-tenant)
preset.panelbodyintegerfan-out width (>=1)
preset.rankbodystring[]escalation order over arms
served_asbodystringServedAs is the model id the serving layer would resolve this blend under.
statusbodystringStatus is "accepted": the blend is well-formed, not that it is now served.

Failure carries the platform error shape — see Errors.

Examples

hanzo benchmark presets create

Benchmark API · All Hanzo APIs · Interactive reference

How is this guide?

On this page