{"record":{"id":"7695063f858c92f4","repo":"RocketChat/Rocket.Chat","slug":"marketplace-unsupported-version-769506","errorCode":null,"errorMessage":"Marketplace_Unsupported_Version","messagePattern":"Marketplace_Unsupported_Version","errorType":"exception","errorClass":"MarketplaceUnsupportedVersionError","httpStatus":400,"severity":"error","filePath":"apps/meteor/ee/server/apps/marketplace/fetchMarketplaceCategories.ts","lineNumber":66,"sourceCode":"\t\tif (error instanceof CloudOfflineLicenseError) {\n\t\t\tthrow error;\n\t\t}\n\t\tthrow new MarketplaceConnectionError('Marketplace_Bad_Marketplace_Connection');\n\t}\n\n\tif (request.status === 200) {\n\t\tconst response = await request.json();\n\t\tfetchMarketplaceCategoriesSchema.parse(response);\n\t\treturn response;\n\t}\n\n\tconst response = await request.json();\n\n\tApps.getRocketChatLogger().error({ msg: 'Error fetching marketplace categories', status: request.status, response });\n\n\t// TODO: Refactor cloud to return a proper error code on unsupported version\n\tif (request.status === 426 && 'errorMsg' in response && response.errorMsg === 'unsupported version') {\n\t\tthrow new MarketplaceUnsupportedVersionError();\n\t}\n\n\tconst INTERNAL_MARKETPLACE_ERROR_CODES = [189, 266];\n\n\tif (request.status === 500 && INTERNAL_MARKETPLACE_ERROR_CODES.includes(response.code)) {\n\t\tthrow new MarketplaceAppsError('Marketplace_Internal_Error');\n\t}\n\n\tthrow new MarketplaceAppsError('Marketplace_Failed_To_Fetch_Categories');\n}\n","sourceCodeStart":48,"sourceCodeEnd":77,"githubUrl":"https://github.com/RocketChat/Rocket.Chat/blob/b2c16d5842cbe6b69b59bdf6fc5e5f1afcd1f0b0/apps/meteor/ee/server/apps/marketplace/fetchMarketplaceCategories.ts#L48-L77","documentation":"MarketplaceUnsupportedVersionError ('Marketplace_Unsupported_Version') from fetchMarketplaceCategories: identical semantics to 170 but for the categories listing — the cloud responds 426 Upgrade Required with errorMsg 'unsupported version', declaring this server version cannot use the marketplace categories API. The response is logged as 'Error fetching marketplace categories' before the throw.","triggerScenarios":"Loading the marketplace EXPLORER which fetches categories, on a server version the cloud has deprecated; the apps list may separately succeed or fail with its own error (170), but this throw is specifically the categories call.","commonSituations":"Old/EOL server builds after cloud deprecation windows; restored snapshots from deprecated versions; fork builds with unrecognized version strings.","solutions":["Upgrade the server to a supported release and reload the marketplace explorer.","Verify reported version in Administration -> Info.","Use direct app installs (zip upload or app ID) while an upgrade is scheduled.","Confirm the cloud minimum-version policy in release notes when choosing the upgrade target."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":"try {\n  const cats = await fetchMarketplaceCategories();\n} catch (e) {\n  if (e instanceof MarketplaceUnsupportedVersionError) {\n    renderUpgradeRequiredBanner(); // categories and apps both require a supported server version\n  }\n}","preventionTips":["Upgrade on a schedule tied to cloud support windows, not after breakage.","Handle the unsupported-version error once for both apps and categories fetches.","Skip category filters when they fail; app search still works on some versions."],"tags":["marketplace","categories","versioning","cloud","upgrade-required","enterprise"],"backgroundTag":"api-version-unsupported","analyzedSha":"b2c16d5842cbe6b69b59bdf6fc5e5f1afcd1f0b0","analyzedAt":"2026-08-18T15:26:39.429Z","contentChangedAt":"2026-08-18T15:26:39.429Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}