Hanzo AI

Flag

Feature flags: ship it dark, then turn it on for who you pick.

Also for this capability: API · CLI · MCP · SDKs

Feature flags: ship it dark, then turn it on for who you pick.

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

Specification

Specification pending — no HIP in hanzoai/hips declares capability: flag 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
RESTflag at its own prefix8 operations
CLIhanzo flag …8 of 8
SDKno published client declares one yet — regenerating the clients is what adds them
MCPtool flags on https://api.hanzo.ai/v1/mcp8 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/flag/defs, operation get_flag_defs:

hanzo flag defs list

Answers 200 with object — ok.

Endpoints

EndpointWhat it does
GET /v1/flag/activityReturns the caller's flag change log newest-first: every create, update and delete, with the actor and the time.
POST /v1/flag/decideEvaluate runs the caller's flag definitions for one identity and returns the flag verdict: which flags are on (or which variant), their payloads, and…
GET /v1/flag/defs/{key}Returns one flag definition by key, or 404 when the caller's store has none under that key.
PUT /v1/flag/defs/{key}Creates or replaces the flag definition at the path's key and returns the stored row.
DELETE /v1/flag/defs/{key}Removes one flag definition by key and records the deletion in the change log.
GET /v1/flag/defsReturns every flag definition in the caller's (org, project) store, by key, with its version and who last changed it.
GET /v1/flag/healthHealth reports that the flag engine is serving.
POST /v1/flagEvaluate runs the caller's flag definitions for one identity and returns the flag verdict: which flags are on (or which variant), their payloads, and…

All Hanzo APIs · Interactive reference

How is this guide?