Errors

​

Common categories

• Auth errors: missing/invalid API key
• Validation errors: invalid body fields
• State errors: expired intent
• Internal errors: temporary server failures

​

Handling strategy

• Do not retry invalid auth/validation requests.
• Retry network and transient server failures with backoff.
• Log request context and error code for support.
• Show user-safe messages in UI and keep internal details in logs.

​

Example

{
  "error": "invalid_body"
}