Adrata Developers
Errors use RFC 7807 problem details with request IDs, docs URLs, retryability, and field errors.
{
"type": "https://docs.adrata.com/errors/validation_failed",
"title": "Validation failed",
"status": 422,
"detail": "One or more fields are invalid.",
"request_id": "01J...",
"error_code": "validation_failed",
"retryable": false,
"field_errors": [{ "field": "domain", "message": "must be a valid domain" }]
}SDKs raise `AuthError`, `RateLimitError`, `ConflictError`, and `AdrataError`. Log `request_id` and preserve `field_errors` for user-facing validation.
Retry 429s after `Retry-After`, retry explicitly retryable 5xx responses with exponential backoff, and never retry non-idempotent writes unless you sent an `Idempotency-Key`.