Common API error codes

Common API error codes

401 Unauthorized

Your API key is missing or invalid.

Fix: Check that you are including the key in the correct header format: Authorization: Bearer YOUR_KEY. Verify the key is still active in Settings → API Keys.

403 Forbidden

You are authenticated but don't have access to this resource.

Fix:

• Confirm you have an active subscription to this API


• Check that your subscription plan includes the endpoint you're calling


• If you hit a daily AI generation limit, buy credits from Dashboard → Credits

429 Too Many Requests

You've exceeded the rate limit for your subscription plan.

Fix: Implement exponential backoff with jitter. Upgrade your plan for higher rate limits. Check the Retry-After response header for when to retry.

500 Internal Server Error

An unexpected error on the server side.

Fix: Retry the request after a short delay. If the problem persists, check the status page and contact support with the request ID from the response.

503 Service Unavailable

The API or platform is temporarily unavailable.

Fix: Check the status page for active incidents. Retry with exponential backoff.