Error Handling

Inboxlayer returns JSON errors with structured fields.

{
  "error": {
    "message": "...",
    "code": "error_code",
    "details": {}
  }
}

Agent-safe handling

• Log status, endpoint, and request identifier.
• Retry with exponential backoff for network and 5xx failures.
• Treat 401 as token refresh opportunities.
• Do not retry payload-validation failures blindly.

Typical behavior

• 401: re-authenticate and retry safe requests.
• 403: check account/inbox scope and permissions.
• 422: fix payload and retry with corrected request.
• 429: apply server-directed backoff behavior.

Recommended workflow policy

• Persist message/action state before writes.
• Use one retry budget per object.
• Escalate repeated non-recoverable failures.