API troubleshooting

API-specific troubleshooting.

Symptom	Likely cause	Fix
401	Missing/invalid API key	Check X-API-Key header
403	Wrong scope or wrong org	Verify key scope; switch active org
404	Wrong ID or different org	Check ID; check active org
429	Rate limited	Honor Retry-After; back off
5xx	Transient	Retry with exponential backoff

Always include X-Request-ID in support tickets.

See also

• API errors