API error types
When a request itself fails, the API answers with application/problem+json (RFC 9457). Its type field is one of the addresses below. A blocked site is not an error: it comes back as a normal 2xx response with the outcome blocked.
| type | HTTP | Meaning |
|---|---|---|
unauthorized | 401 | Unauthorized |
forbidden | 403 | Forbidden |
not-found | 404 | Not found |
invalid-parameter | 400 | Invalid parameter |
invalid-request | 422 | Invalid request |
invalid-url | 422 | Invalid URL |
invalid-target | 422 | Invalid target |
unknown-operator | 422 | Unknown operator |
idempotency-key-reuse | 422 | Idempotency key reused |
rate-limited | 429 | Too many requests |
internal | 500 | Internal error |