Hanzo AI

Channel

One inbox for the chat apps you connect — Discord, Slack, Teams, Telegram.

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

One inbox for the chat apps you connect — Discord, Slack, Teams, Telegram.

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

Specification

Specification pending — no HIP in hanzoai/hips declares capability: channel 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
RESTchannel at its own prefix9 operations
CLIhanzo channel …9 of 9
SDKno published client declares one yet — regenerating the clients is what adds them
MCPtool channels on https://api.hanzo.ai/v1/mcp7 operations, 3 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/channel, operation get_channel:

hanzo channel list

Answers 200 with object — ok.

Endpoints

EndpointWhat it does
POST /v1/channel/{channel}/sendSend a message from your org's bot to one chat room
GET /v1/channel/agentReturns which agent answers the caller org's channel: the default and every room bound to another agent.
PUT /v1/channel/agentBinds agents to the caller org's channel and answers the bindings as GET would.
GET /v1/channel/allowlistReturns the caller org's access policy for one channel: whether DMs are pairing-gated, allowlisted or open, whether group rooms are open, allowlisted…
PUT /v1/channel/allowlistEdits the caller org's access policy for one channel and answers the policy as GET would, so both verbs return ONE shape.
GET /v1/channel/inboxReturns the messages people have sent to the caller org's connected chat bots, oldest first, in the portable envelope shape every transport…
POST /v1/channel/pairing/approveTurns one pending pairing code into a standing allow entry, so that person can DM the org's bot on that channel from now on.
GET /v1/channel/pairingReturns the pairing requests waiting for the caller org to approve — one per person who messaged a connected bot on a channel whose DM policy is…
GET /v1/channelReports every chat channel this org can send through, and whether it can send through it right now.

All Hanzo APIs · Interactive reference

How is this guide?