API Troubleshooting

What it is

Common API issues: authentication failures, permission errors, and rate limiting.

API key not working

• Header: Ensure you send Authorization: Bearer your_api_key or X-API-Key: your_api_key. No extra spaces.
• Permissions: The key may have scoped permissions. Check that the key has the required permission (e.g. client.* for client endpoints).
• IP allowlist: If the key has an IP allowlist, your server's IP must be included.
• Revoked: Verify the key has not been revoked or rotated.

Rate limits

Default is typically 100 requests per 60 seconds per key. Check response headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1705334400

When exceeded, you receive 429 Too Many Requests. Implement exponential backoff or reduce request frequency.

Common error codes