Error codes
All errors follow RFC 7807 Problem Details format.
| Code | HTTP | Fix |
|---|---|---|
| AUTHENTICATION_REQUIRED | 401 | Include valid API key in Authorization header |
| FORBIDDEN | 403 | Check API key scopes |
| NOT_FOUND | 404 | Verify resource ID |
| VALIDATION_ERROR | 400 | Check error details for field issues |
| RATE_LIMITED | 429 | Wait for Retry-After, then retry |
| QUOTA_EXCEEDED | 402 | Upgrade plan or wait for next cycle |
| TIMEOUT | 504 | Retry with exponential backoff |
| SERVICE_UNAVAILABLE | 503 | Retry. Check status.wave.online |
| INTERNAL_ERROR | 500 | Retry once. Contact support with X-Request-ID |