Overview
/ Base URL, auth, response shapes, and rate limits. Everything else builds on this page.
Base URL
https://app.humaner.ioEndpoints
| Method | Path | Purpose |
|---|---|---|
| POST | /api/v1/chat | Send a message, stream the reply |
| GET | /api/v1/agents/{publicId} | Fetch agent name, character, greeting |
| POST | /api/v1/visitors/identify | Attach a stable visitor ID for cross-session memory |
| POST | /api/v1/handoff/ticket | Create a Human Desk ticket from a custom UI |
Authentication
Every endpoint takes a Bearer API key. Two trust paths exist (API key, browser origin); full detail is on the Authentication page.
Authorization header
Authorization: Bearer hm_live_xxxxxxxxResponse conventions
| Endpoint | Response type |
|---|---|
| POST /api/v1/chat | text/event-stream (SSE). See the Chat reference |
| All others | application/json |
Errors are always { "error": "message" }. Full status code table on the Errors page.
Plan gating
API access itself needs the Frontier plan or higher. Individual fields (live data, cross-session memory) are gated further; noted per field on each page.