API Reference
Hanzo Integrations API
Generic, provider-agnostic OAuth connector plane for Hanzo Cloud — the
Generic, provider-agnostic OAuth connector plane for Hanzo Cloud — the
Hanzo Integrations API · All API references →
| Base URL | https://api.hanzo.ai |
| Version | 1.0.0 |
| Operations | 10 |
Authentication
bearerAuth— HTTP bearer
All Hanzo APIs share one bearer credential and common error and pagination conventions. See API conventions.
curl -H "Authorization: Bearer $HANZO_API_KEY" https://api.hanzo.aiEndpoints
OAuth
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/integrations/{provider}/connect | Begin an OAuth flow (returns the provider authorize URL) |
GET | /v1/integrations/{provider}/callback | OAuth return — seal tokens and redirect to console |
POST | /v1/integrations/{provider}/disconnect | Revoke and forget an org's connection (idempotent) |
Providers
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/integrations | List providers with this org's connection status |
GET | /v1/integrations/{provider} | Get one provider with this org's connection status |
Slack
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/integrations/slack/events | Slack Events API webhook |
POST | /v1/integrations/slack/commands | Slack slash command webhook |
GET | /v1/integrations/slack/link | Begin the per-user account link (leg 1 — Slack sign-in) |
GET | /v1/integrations/slack/link/slack | Slack sign-in callback (leg 2) |
GET | /v1/integrations/slack/link/callback | hanzo.id OIDC callback — bind Slack↔Hanzo (leg 3) |
How is this guide?