Budibase/budibase · error · InvalidBBRefError

Id "${id}" is not valid for the subtype "USER"

Error message

Id "${id}" is not valid for the subtype "USER"

What it means

Error "Id "${id}" is not valid for the subtype "USER"" thrown in Budibase/budibase.

Source

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

  if (!id) {
    return null
  }

  switch (subtype) {
    case BBReferenceFieldSubType.USER: {
      if (id.startsWith(ROW_PREFIX)) {
        id = dbCore.getGlobalIDFromUserMetadataID(id)
      }

      try {
        await cache.user.getUser({
          userId: id,
        })
        return id
      } catch (e: any) {
        if (e.statusCode === 404) {
          throw new InvalidBBRefError(id, BBReferenceFieldSubType.USER)
        }
        throw e
      }
    }

    default:
      throw utils.unreachable(subtype)
  }
}
export async function processInputBBReferences(
  value: string | string[] | { _id: string }[],
  subtype: BBReferenceFieldSubType
): Promise<string[] | null> {
  if (!value || !value[0]) {
    return null
  }

  let referenceIds

View on GitHub (pinned to a81a902e9a)

When it happens

Trigger: Thrown at packages/server/src/utilities/rowProcessor/bbReferenceProcessor.ts:46 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/dc377cd3ac014d65. Report an issue: GitHub.