Hanzo

Experiment

Package experiments is A/B testing anything: a flag, an ad, a subject line, a model.

Package experiments is A/B testing anything: a flag, an ad, a subject line, a model.

Base URLhttps://api.hanzo.ai
Operations7
AuthAuthorization: Bearer $HANZO_API_KEY

Specification

Specification pending — no HIP in hanzoai/hips declares capability: experiment yet. What this capability serves is below, from the API document; what it is — the store it owns, how it meters, what it publishes — is written as a HIP under HIP-0139.

Four surfaces

SurfaceReaches this capability asCoverage
RESTexperiment at its own prefix7 operations
CLIhanzo experiments …7 of 7
SDKno published client declares one yet — regenerating the clients is what adds them
MCPtool experiments on https://api.hanzo.ai/v1/mcp7 operations, 2 under the document's own id — ask describe for the rest

Quickstart

export HANZO_API_KEY=sk-...   # console.hanzo.ai → API keys

Then the first call — a read that needs nothing but the key. GET /v1/experiment, operation get_experiment:

hanzo experiments list

Answers 200 with object — ok.

Endpoints

EndpointWhat it does
POST /v1/experiment/{id}/analyzeIs per-variant conversion, lift and statistical significance against the control arm.
GET /v1/experiment/{id}/assignIs the variant one subject is bucketed into, and the payload that variant carries.
POST /v1/experiment/{id}/decidePromotes one variant to the whole rollout and records who decided.
GET /v1/experiment/{id}Is one experiment's definition and lifecycle: variants, weights, control arm, status and winner.
GET /v1/experiment/healthIs whether the experiments subsystem is mounted and serving in this process.
GET /v1/experimentIs every experiment in the caller's org, with its variants, status and decision, ordered by project then id.
POST /v1/experimentRegisters a controlled experiment AND puts its assignment flag live, in that order, so the arms start bucketing subjects the moment this returns 201…

All Hanzo APIs · Interactive reference

How is this guide?

On this page