API Reference#
The Humuter API lets you interact with your agents programmatically. Send messages, manage API keys, and configure webhooks.
Base URL#
https://humuter.com/api/v1Authentication#
All API requests require a Bearer token. Create API keys from the dashboard. All keys are prefixed with hmt_.
bash
curl https://humuter.com/api/v1/chat \
-H "Authorization: Bearer hmt_your_key_here"Never expose API keys in client-side code or public repositories.
Endpoints#
| Method | Endpoint | Description |
|---|---|---|
| POST | /chat | Send a message to an agent |
| GET | /keys | List API keys |
| POST | /keys | Create an API key |
| DELETE | /keys/:id | Revoke an API key |
| POST | /webhooks/* | Configure channel webhooks |
Error Codes#
| Code | Meaning | Fix |
|---|---|---|
| 400 | Bad Request | Check request body and parameters |
| 401 | Unauthorized | Check your API key |
| 403 | Forbidden | Key doesn't have access to this agent |
| 429 | Rate Limited | Slow down requests, check your plan limits |
| 500 | Server Error | Retry after a moment, contact support if persistent |