{"title":"Skip API data upgrade in cloud migration","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/migration-skip-api-data-upgrade/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/migration-skip-api-data-upgrade, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/migration-skip-api-data-upgrade","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how to skip API data upgrade for selected companies during Business Central cloud migration and complete the upgrade after going live.","date":"2026-11-17","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Skip API data upgrade in cloud migration","slug":"skip-api-data-upgrade-in-cloud-migration","at":0,"chars":2945},{"level":2,"title":"Skip from the online environment","slug":"skip-from-the-online-environment","at":698,"chars":903},{"level":2,"title":"Skip from on-premises upgrade","slug":"skip-from-on-premises-upgrade","at":1601,"chars":1121},{"level":2,"title":"Completing API data upgrade after going live","slug":"completing-api-data-upgrade-after-going-live","at":2722,"chars":169},{"level":2,"title":"Next steps","slug":"next-steps","at":2891,"chars":54}],"text":"# Skip API data upgrade in cloud migration\nWhen running the data upgrade during cloud migration, you can experience a long-running upgrade because of the API upgrade. To prevent this condition, you can skip the API data upgrade during cloud migration, and then run it after going live on the tenant. Skipping the API data upgrade is done on a per-company basis. The affected API entities aren't ready for use until you complete their data upgrades.\nThere are two ways to skip the API data upgrade during cloud migration. One way is to disable it as part of the on-premises upgrade process. The other way is to disable it using cloud migration management in the Business Central online environment.\n## Skip from the online environment\nBefore you can do this task, you have to complete cloud migration setup and data replication.\n1. Sign in to Business Central online<https://businesscentral.dynamics.com>.\n1. Search for and open the Cloud Migration Management page.\n1. Select the Manage API Upgrade action to open the API Upgrade Overview page.\n1. To disable the API data upgrade for a company, do the following steps:\n 1. On the API Upgrade Overview page, select the company in the Company Name column.\n  The API Data Upgrade List opens in a new browser tab.\n 1. On the API Data Upgrade List page, select Disable API Data Upgrades > OK.\n  You can close the API Data Upgrade List tab after you make the selection.\n1. Repeat the previous step for each company you want to disable the API data upgrade.\nThe API Upgrade Overview page doesn't show the changes until it's refreshed. Press F5 to refresh it.\n## Skip from on-premises upgrade\nYou can use the following SQL query to skip upgrade for a single company. Replace SetCompanyName with the company name. Run the query only if the disable tag doesn't already exist for that company:\n```sql\nDECLARE @UpgTag nvarchar(250);\nSET @UpgTag = UPPER('MS-469217-DisableAPIDataUpgrade-20230411')\n\nINSERT INTO [dbo].[Upgrade Tags$63ca2fa4-4f03-4f2b-a480-172fef340d3f] (Tag, [Tag Timestamp], [Skipped Upgrade], Company)\nVALUES (\n    UPPER(@UpgTag),\n    '1753-01-01 00:00:00.000',\n    1,\n    UPPER('SetCompanyName')\n);\n```\nYou can use the following SQL query to skip upgrade for all companies:\n```sql\nDECLARE @UpgTag nvarchar(250);\n\nSET @UpgTag = UPPER('MS-469217-DisableAPIDataUpgrade-20230411')\n\nINSERT INTO [dbo].[Upgrade Tags$63ca2fa4-4f03-4f2b-a480-172fef340d3f] (Tag, [Tag Timestamp], [Skipped Upgrade], Company)\nSELECT\n    UPPER(@UpgTag),\n    '1753-01-01 00:00:00.000',\n    1,\n    UPPER([Name])\nFROM\n    Company\nWHERE\n    UPPER([Name]) NOT IN (\n        SELECT [Company]\n        FROM [Upgrade Tags$63ca2fa4-4f03-4f2b-a480-172fef340d3f]\n        WHERE Tag = UPPER(@UpgTag)\n    )\n```\n## Completing API data upgrade after going live\nWhen you're finished with the cloud migration, run the API data upgrade. See Run API data upgrade<migration-finish#API>.\n## Next steps\nRun data upgrade<migration-data-upgrade>"}