Silence defined error codes (baserow#5012)

Author: dimmur-brw

changelog/entries/unreleased/refactor/5011_silence_defined_error_codes_in_sentry.json

@@ -0,0 +1,9 @@
+{
+    "type": "refactor",
+    "message": "Silence defined error codes in Sentry",
+    "issue_origin": "github",
+    "issue_number": 5011,
+    "domain": "core",
+    "bullet_points": [],
+    "created_at": "2026-03-19"
+}

web-frontend/modules/core/utils/sentryErrors.js

@@ -0,0 +1,5 @@
+// API error codes to silence in Sentry, keyed by HTTP status code.
+// These are handled by the application (e.g. forceLogoff) and are not bugs.
+export const SILENCED_API_ERRORS = {
+  401: ['ERROR_INVALID_ACCESS_TOKEN', 'ERROR_INVALID_REFRESH_TOKEN'],
+}

web-frontend/sentry.client.config.ts

@@ -1,5 +1,6 @@
 import { useRuntimeConfig, useAppConfig, useRouter } from '#imports'
 import { makeFakeTransport } from './modules/core/utils/sentryFakeTransport'
+import { SILENCED_API_ERRORS } from './modules/core/utils/sentryErrors'
 import * as Sentry from '@sentry/nuxt'
 
 const config = useRuntimeConfig()
@@ -30,14 +31,21 @@ if (dsn && dsn !== '') {
     ...(isDev ? { transport: makeFakeTransport } : {}),
     beforeSend(event, hint) {
       const err = hint?.originalException
-      if (err?.fatal === false || err?.response?.status === 401) return null
+      if (err?.fatal === false) return null
 
       // Filter out axios errors without a response like
       // network error, timeout, aborted, cancelled requests
       if (err?.name === 'AxiosError' && !err?.response) {
         return null
       }
 
+      // Filter known API errors that are handled by the application (e.g. forceLogoff).
+      const status = err?.response?.status || err?.statusCode
+      const errorCode = err?.response?.data?.error || err?.data?.error
+      if (SILENCED_API_ERRORS[status]?.includes(errorCode)) {
+        return null
+      }
+
       if (isDev) {
         console.error('[Sentry captured error]', `${err}`)
         return null

web-frontend/sentry.server.config.ts

@@ -1,6 +1,7 @@
 import { useRuntimeConfig } from '#imports'
 import * as Sentry from '@sentry/nuxt'
 import { makeFakeTransport } from './modules/core/utils/sentryFakeTransport'
+import { SILENCED_API_ERRORS } from './modules/core/utils/sentryErrors'
 
 const config = useRuntimeConfig()
 const dsn =
@@ -18,7 +19,14 @@ if (dsn && dsn !== '') {
     ...(isDev ? { transport: makeFakeTransport } : {}),
     beforeSend(event, hint) {
       const err = hint?.originalException
-      if (err?.fatal === false || err?.response?.status === 401) return null
+      if (err?.fatal === false) return null
+
+      // Filter known API errors that are handled by the application (e.g. forceLogoff).
+      const status = err?.response?.status || err?.statusCode
+      const errorCode = err?.response?.data?.error || err?.data?.error
+      if (SILENCED_API_ERRORS[status]?.includes(errorCode)) {
+        return null
+      }
       if (isDev) {
         console.error('[Sentry captured error]', err)
         return null