## Handling API Errors

The API client throws three distinct error types:

  ForbiddenError  (403): User is not allowed to perform this action.
                        Show a permission-specific message. Do NOT retry.

  ApiError        (4xx, 5xx): Network or server error.
                        Show a retry-prompting message for recoverable errors.

  ValidationError (schema mismatch): API response shape changed.
                        Log to Sentry. Show 'please update the app' in production.

Always catch ForbiddenError separately from ApiError.
Never show a retry invitation for a 403 response.
