API Reference
Hanzo Bot API
Hanzo Bot Hub is the skill registry and marketplace for Hanzo Bot.
Hanzo Bot Hub is the skill registry and marketplace for Hanzo Bot.
All Hanzo APIs share one bearer credential and common error and pagination conventions. See API conventions.
curl -H "Authorization: Bearer $HANZO_API_KEY" https://app.hanzo.bot
| Method | Endpoint | Description |
|---|
GET | /v1/bot/auth/login | Initiate OAuth login via Hanzo IAM |
GET | /v1/bot/auth/callback | OAuth callback - exchange code for session |
GET | /v1/bot/auth/me | Get current authenticated user |
POST | /v1/bot/auth/logout | Invalidate current session |
GET | /v1/bot/whoami | CLI alias for /v1/bot/auth/me |
| Method | Endpoint | Description |
|---|
GET | /health | Health check |
| Method | Endpoint | Description |
|---|
GET | /v1/bot/integrations | List integrations (paginated) |
GET | /v1/bot/integrations/{slug} | Get integration detail with latest version |
| Method | Endpoint | Description |
|---|
GET | /v1/bot/personas | List personas (paginated) |
GET | /v1/bot/personas/{slug}/detail | Get persona detail including latest version and owner |
GET | /v1/bot/personas/{slug}/versions | List versions of a persona |
| Method | Endpoint | Description |
|---|
GET | /v1/bot/search/skills | Hybrid vector + lexical search for skills |
GET | /v1/bot/search/personas | Lexical search for personas |
| Method | Endpoint | Description |
|---|
GET | /v1/bot/skills | List published skills (paginated) |
GET | /v1/bot/skills/{slug} | Get skill details by slug |
DELETE | /v1/bot/skills/{slug} | Soft-delete a skill (owner or admin only) |
POST | /v1/bot/skills/{slug}/publish | Publish a new version of a skill (creates skill if new) |
POST | /v1/bot/skills/{slug}/undelete | Restore a soft-deleted skill |
GET | /v1/bot/skills/{slug}/versions | List versions of a skill |
GET | /v1/bot/skills/{slug}/versions/{version}/files | Get file listing for a specific version |
POST | /v1/bot/skills/{slug}/stars | Star or unstar a skill (toggle) |
GET | /v1/bot/skills/{slug}/stars/me | Check if current user has starred this skill |
GET | /v1/bot/skills/{slug}/comments | List comments on a skill |
POST | /v1/bot/skills/{slug}/comments | Add a comment to a skill |
DELETE | /v1/bot/skills/{slug}/comments/{commentId} | Delete a comment (author or admin only) |
| Method | Endpoint | Description |
|---|
GET | /v1/bot/tokens | List current user's API tokens |
POST | /v1/bot/tokens | Create a new API token |
DELETE | /v1/bot/tokens/{id} | Revoke an API token |
| Method | Endpoint | Description |
|---|
POST | /v1/bot/upload/url | Generate a presigned upload URL |
| Method | Endpoint | Description |
|---|
GET | /v1/bot/users/{handle} | Get user profile by handle |
GET | /v1/bot/users/{handle}/skills | List skills published by a user |
GET | /v1/bot/users/{handle}/stars | List skills starred by a user |
PATCH | /v1/bot/users/me | Update current user's profile |
Hanzo Bot API guide · All Hanzo APIs · OpenAPI spec
How is this guide?