Budibase/budibase · error · InvalidBBRefError

Id "${notFoundIds[0]}" is not valid for the subtype "USER"

Error message

Id "${notFoundIds[0]}" is not valid for the subtype "USER"

What it means

Error "Id "${notFoundIds[0]}" is not valid for the subtype "USER"" thrown in Budibase/budibase.

Source

Thrown at packages/server/src/utilities/rowProcessor/bbReferenceProcessor.ts:95

  // they may be user metadata references (start with row prefix)
  // and these need to be converted to global IDs
  referenceIds = referenceIds.map(id => {
    if (id?.startsWith(ROW_PREFIX)) {
      return dbCore.getGlobalIDFromUserMetadataID(id)
    } else {
      return id
    }
  })

  switch (subtype) {
    case undefined:
      throw "Subtype must be defined"
    case BBReferenceFieldSubType.USER:
    case BBReferenceFieldSubType.USERS: {
      const { notFoundIds } = await cache.user.getUsers(referenceIds)

      if (notFoundIds?.length) {
        throw new InvalidBBRefError(
          notFoundIds[0],
          BBReferenceFieldSubType.USER
        )
      }

      if (!referenceIds?.length) {
        return null
      }

      return referenceIds
    }
    default:
      throw utils.unreachable(subtype)
  }
}

interface UserReferenceInfo {
  _id: string

View on GitHub (pinned to a81a902e9a)

When it happens

Trigger: Thrown at packages/server/src/utilities/rowProcessor/bbReferenceProcessor.ts:95 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Budibase/budibase@a81a902e9a (2026-08-29). Data as JSON: /api/errors/35ac8811dbc6d96a. Report an issue: GitHub.