RocketChat/Rocket.Chat · error · MarketplaceAppsError

Marketplace_Invalid_Apps_Engine_Version

Error message

Marketplace_Invalid_Apps_Engine_Version

What it means

MarketplaceAppsError with code 'Marketplace_Invalid_Apps_Engine_Version', thrown when the apps-list fetch returns HTTP 400 with body code 200 — the cloud's overloaded way of saying the server's Apps Engine version is incompatible with the marketplace (e.g. the apps framework version sent is no longer accepted for browsing/installing apps). Distinct from 170 (426 unsupported server version) and 172 (cloud internal errors).

Solutions

1. Upgrade Rocket.Chat (which bundles the matching apps-engine) to a supported release and retry the marketplace listing.
2. Confirm apps-engine version consistency (no manually pinned @rocket.chat/apps-engine in a fork build).
3. As a workaround, install the specific app zip manually if the app itself still supports your engine.
4. If on the latest version already, clear cloud cache by re-syncing Connectivity Services and file an issue — it may be a cloud-side regression.

try {
  const apps = await fetchMarketplaceApps();
} catch (e) {
  if (e instanceof MarketplaceAppsError && e.message === 'Marketplace_Invalid_Apps_Engine_Version') {
    // permanent incompatibility: upgrade server/apps-engine; fall back to manual zip install
  }
}

When it happens

Trigger: Browsing or syncing marketplace apps from a server whose apps-engine framework version is outside the range the cloud accepts: usually old 1.x/2.x engine builds behind a much newer cloud, or a mismatch after partial upgrades where apps-engine was not updated with the server.

Common situations: Server upgraded but apps-engine package pinned/frozen by a fork; very old installs attempting marketplace sync; community builds with dev version strings; cloud raising minimum engine version after deprecation.

Related errors

• Marketplace_Unsupported_Version
• Marketplace_Unsupported_Version
• App metadata download failed
• App package download failed
• Invalid response from the Marketplace

AI-assisted analysis of RocketChat/Rocket.Chat@b2c16d5842 (2026-08-18). Data as JSON: /api/errors/95aea4cff922e62d. Report an issue: GitHub.

Appendix: source

Thrown at apps/meteor/ee/server/apps/marketplace/fetchMarketplaceApps.ts:186

	}

	if (request.status === 200) {
		const response = await request.json();
		fetchMarketplaceAppsSchema.parse(response);
		return response;
	}

	const response = await request.json();

	Apps.getRocketChatLogger().error({ msg: 'Error fetching marketplace apps', status: request.status, response });

	// TODO: Refactor cloud to return a proper error code on unsupported version
	if (request.status === 426 && 'errorMsg' in response && response.errorMsg === 'unsupported version') {
		throw new MarketplaceUnsupportedVersionError();
	}

	if (request.status === 400 && response.code === 200) {
		throw new MarketplaceAppsError('Marketplace_Invalid_Apps_Engine_Version');
	}

	const INTERNAL_MARKETPLACE_ERROR_CODES = [266, 256, 166, 221, 257, 320];

	if (request.status === 500 && INTERNAL_MARKETPLACE_ERROR_CODES.includes(response.code)) {
		throw new MarketplaceAppsError('Marketplace_Internal_Error');
	}

	throw new MarketplaceAppsError('Marketplace_Failed_To_Fetch_Apps');
}

View on GitHub (pinned to b2c16d5842)