X-API-Key header.
API key types
| Type | Duration | Rate Limit | How to Get |
|---|---|---|---|
| Test key | 10 minutes | 60 req/min | POST /api/v1/test-key (no auth required) |
| Production key | Permanent | 300 req/min | Contact us |
Rate limits
Requests are rate-limited per API key:- Test keys: 60 requests per minute
- Production keys: 300 requests per minute
429 Too Many Requests response. Wait and retry.
Error codes
All errors return JSON with anerror field:
| Code | Meaning |
|---|---|
400 | Bad Request — invalid parameters |
401 | Unauthorized — missing or invalid API key |
404 | Not Found — resource doesn’t exist |
429 | Too Many Requests — rate limit exceeded |
500 | Server Error — something went wrong on our end |
Unauthenticated endpoints
A few endpoints don’t require an API key:POST /api/v1/test-key— generate a test keyGET /health— health checkPOST /api/v1/auth/signup— create a user accountPOST /api/v1/auth/login— authenticate and get a session token

