API error codes
Errors from /api/external/v1 look like this:
{ "success": false, "error": "INVALID_API_KEY", "message": "..." }| Code | Usually means |
|---|---|
UNAUTHORIZED (401) | No Authorization header, or it isn't in the Bearer <key> format |
INVALID_API_KEY (401) | The key is wrong or was revoked |
API_KEY_EXPIRED (401) | The key has expired; create a new one |
FORBIDDEN (403) | The key doesn't have permission for this endpoint, or it's scoped to a different microsite |
NOT_FOUND (404) | The ID in the URL doesn't exist or isn't yours |
VALIDATION_ERROR (400) | A parameter is missing or invalid; the message says which |
RATE_LIMIT_EXCEEDED (429) | Too many requests; wait retry_after seconds |
INTERNAL_ERROR (500) | Something failed on our side; retry later |
If an error keeps happening, note the time, the endpoint and the error message (never the key), and ask the AI assistant to connect you with a person.