Hanzo

Link

Package link is the unified AI login manager's registry: the org+user-scoped record of WHICH provider accounts (Claude Max, ChatGPT Plus, a Hanzo API key, a raw provider key) a developer has signed…

Package link is the unified AI login manager's registry: the org+user-scoped record of WHICH provider accounts (Claude Max, ChatGPT Plus, a Hanzo API key, a raw provider key) a developer has signed into, ON WHICH MACHINES, with each account's latest usage snapshot.

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

Specification

Specification pending — no HIP in hanzoai/hips declares capability: link 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
RESTlink at its own prefix11 operations
CLIhanzo links …11 of 11
SDKno published client declares one yet — regenerating the clients is what adds them
MCPtool link on https://api.hanzo.ai/v1/mcp11 operations, 4 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/link, operation get_link:

hanzo links list

Answers 200 with object — ok.

Endpoints

EndpointWhat it does
GET /v1/link/{id}Reads one linked account.
DELETE /v1/link/{id}Logs out one account and stops the sessions it was running.
POST /v1/link/devices/{machine}/revokeLogs out every account on one machine and stops its sessions.
GET /v1/link/devices/{machine}Shows one machine: its accounts, usage and live sessions.
GET /v1/link/routeGets the failover order across your linked accounts.
GET /v1/link/usage/accountsBreaks down what the gateway routed through each of your accounts.
GET /v1/link/usage/summaryShows plan consumption and Hanzo spend side by side.
GET /v1/link/usageShows one provider account's own usage dashboard.
POST /v1/link/usageReports usage samples from the device collector.
GET /v1/linkLists your linked accounts and the devices they sit on.
POST /v1/linkRegisters a signed-in AI provider account on a machine.

All Hanzo APIs · Interactive reference

How is this guide?

On this page