Skip to main content

HTTP status codes

The status codes Authnull returns and what each means for your client.

CodeMeaningWhen it happens
200OKRequest succeeded. A read may still return an empty collection.
201CreatedA resource was created. Returned by some write endpoints.
400Bad requestMalformed JSON, missing required field, or a filterBy column that does not exist.
401UnauthorizedX-Authorization missing, malformed or expired.
403ForbiddenValid token, wrong scope: orgId, tenantId or domainId outside the token's reach.
404Not foundUnknown path, or a referenced record that does not exist in this tenant.
409ConflictResource already exists — re-adding an onboarded domain, or a duplicate policy name.
429Too many requestsRate limit exceeded. Back off before retrying.
500Server errorPlatform failure. Retry once with backoff, then contact support.
Rate limits undocumented.

429 is listed for completeness. No rate limit values were supplied — if limits exist, publish the threshold, window and any Retry-After header.