Developer
Authentication
Authenticate API requests safely.
Common auth methods
| Method | Used for |
|---|---|
| Supabase session cookies | Dashboard and user-authenticated API routes. |
| Scoped API keys | Chatbot widgets, external products, and product APIs. |
| Install tokens | One-time Hermes installation. |
| Telemetry tokens | Hermes event ingestion. |
| HMAC signing | Server-to-worker calls such as developer automation. |
Headers
For server-to-server APIs, prefer:
Authorization: Bearer <token>
Content-Type: application/jsonNever log full token values. Store tokens in environment variables or a secret manager.