API Reference
Hanzo KB API
Knowledge Base retrieval + ingestion control-plane — the `/v1/kb/*` surface
Knowledge Base retrieval + ingestion control-plane — the /v1/kb/* surface
Hanzo KB API · All API references →
| Base URL | https://api.hanzo.ai |
| Version | 1.0.0 |
| Operations | 7 |
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
Connectors
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/kb/connectors | List this org's connectors and connection state |
GET | /v1/kb/connectors/catalog | List every connectable source (native + long-tail pieces) |
GET | /v1/kb/connectors/{provider}/connect | Begin an OAuth connection (returns the provider authorize URL) |
GET | /v1/kb/connectors/{provider}/callback | OAuth callback (provider redirect — org recovered from signed state) |
POST | /v1/kb/connectors/{provider}/sync | Sync the provider's documents into this org's knowledge store |
DELETE | /v1/kb/connectors/{provider} | Disconnect a connector (tombstone token, purge its vector points) |
Search
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/kb/search | Semantic search over the org's knowledge |
How is this guide?