actualbudget/actual · error

invalid groupId

Error message

invalid groupId

What it means

Error "invalid groupId" thrown in actualbudget/actual.

Source

Thrown at packages/sync-server/src/app-sync.ts:325

  const fileId = req.headers['x-actual-file-id'];

  if (!fileId || typeof fileId !== 'string') {
    res.status(400).send('fileId is required');
    return;
  }
  if (!isValidFileId(fileId)) {
    res.status(400).send('invalid fileId');
    return;
  }

  let groupId = req.headers['x-actual-group-id'] || null;
  const encryptMeta = extractSingleHeader(req, res, 'x-actual-encrypt-meta');
  if (res.headersSent) return;
  const syncFormatVersion = extractSingleHeader(req, res, 'x-actual-format');
  if (res.headersSent) return;

  if (!!groupId && (typeof groupId !== 'string' || !isValidGroupId(groupId))) {
    res.status(400).send('invalid groupId');
    return;
  }

  const keyId =
    encryptMeta && typeof encryptMeta === 'string'
      ? JSON.parse(encryptMeta).keyId
      : null;

  const filesService = new FilesService(getAccountDb());
  let currentFile;

  try {
    currentFile = filesService.get(fileId);
  } catch (e) {
    if (e instanceof FileNotFound) {
      currentFile = null;
    } else {
      throw e;

View on GitHub (pinned to d4334cb6e6)

When it happens

Trigger: Thrown at packages/sync-server/src/app-sync.ts:325 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of actualbudget/actual@d4334cb6e6 (2026-08-29). Data as JSON: /api/errors/7891ece6e35e374a. Report an issue: GitHub.