Errors are returned as application/problem+json:
{
"type": "about:blank",
"title": "No such policy",
"status": 404,
"request_id": "d32c3ee9-1001-4191-9440-3b790420a589"
}
titleis a short, human-readable reason.statusrepeats the HTTP status.detail, when present, gives specifics: the fields that failed validation as{ "path", "message" }pairs, orcurrent_versionwhen the privacy notice has changed.request_ididentifies the request. Quote it when you contact us.
Statuses
| Status | Meaning | What to do |
|---|---|---|
| 400 | A required header or parameter is missing or invalid, for example Idempotency-Key or an unknown category | Fix the request |
| 401 | An agent access token is required; WWW-Authenticate points to the protected resource metadata | Register and send a token |
| 403 | The token lacks the required scope | Request the scope |
| 404 | No such resource | Check the path |
| 409 | Already submitted for this agent registration, or the privacy notice changed since you read it | Do not resubmit; or read the notice again and resend with detail.current_version |
| 413 | The body is too large | Shorten it |
| 415 | The body is not JSON | Send Content-Type: application/json |
| 422 | The body failed validation | Fix the fields in detail |
| 429 | Too many requests | Wait, then retry |
| 503 | The capability is closed or temporarily unavailable | Check /capabilities.json and /status.json |