Errors and retries
Error format
An error response contains detail: a string, an object with code/message, or a list of validation errors. Use the HTTP status and machine-readable code where available, rather than matching translated messages.
{"detail":"..."}{"detail":{"code":"...","message":"..."}}HTTP status codes
400- Invalid header or identifier. Check your request.
401- The session or key was not accepted. Sign in again or check your key.
403- Insufficient rights or access to the mailbox is denied.
404- The resource was not found or is not available to the current account.
409- Folder state, quota, or generation conflict. Please update your data before retrying.
413- The file size exceeds the allowed limit.
422- Invalid request parameters. Check the fields provided in the response.
429- Too many requests. Please try again later.
503- The service is temporarily unavailable. Retry the request with a delay.
After 401, authenticate again. After 409, refresh the resource state. Retry 503 responses with a delay, keeping the original Idempotency-Key for sends. Do not blindly repeat irreversible actions.