Skip to main content

​
Errors

Most /api/v1 Public API errors are oRPC transport errors serialized as JSON. Common fields:
  • code: transport code such as UNAUTHORIZED, FORBIDDEN, NOT_FOUND, or INTERNAL_SERVER_ERROR
  • message: human-readable error message
  • data.appCode: optional stable application-specific reason
  • issues: validation details for malformed input
Plain Express app-level errors outside oRPC use RFC 7807 problem details. Clients should branch on stable codes, not on message text. See: packages/backend/src/app/error-handler.ts