Add notice on GetMigrationJobProgress API in Migration API Overview (SharePoint#10325)

* Create migration-job-progress-api-reference.md

* Update migration-job-progress-api-reference.md

* Update migration-job-progress-api-reference.md

Revised broken links

* Update migration-job-progress-api-reference.md

Replace with relative links

* fix markdown issues, grammar, typos

## markdown

in accordance with msdocs guidelines, applied the following changes:

- always have empty lines between headings, paragraphs, and fenced code blocks
- fenced code language fixes:
  - no such language **rest**... changed to `http` or `json` where applicable
- used inline formatting where applicable

* Add notice on GetMigrationJobProgress API

* Add notice on GetMigrationJobProgress API in Migration API Reference

* update doc date

* update doc date

---------

Co-authored-by: Andrew Connell <[email protected]>

Author: shiongzuo

docs/apis/migration-api-overview.md

@@ -1,7 +1,7 @@
 ---
 title: "SharePoint Import Migration API"
 description: "This article provides overview information on how to use the SharePoint Migration API."
-ms.date: 07/03/2024
+ms.date: 07/16/2025
 ms.author: ranren
 author: underreview
 manager: dapodean
@@ -47,6 +47,10 @@ Start a migration job with three steps. Check the guidance in each of the steps
 
 ### Provision the destination containers and the queue
 
+> [!IMPORTANT]
+> Use [GetMigrationJobProgress API](migration-job-progress-api-reference.md) to retrieve migration job status. 
+> Provisioning Azure Queues for migration job status tracking is no longer required. Deprecation is planned for the second half of 2026. Until then, Azure Queues will remain available for status retrieval.
+
 Use the `ProvisionMigrationContainers` method to provision the containers. Check [Use Azure Blob Storage Containers and Azure Queues with Migration API](migration-azure.md) for details. You can also use your own containers and queues if needed.
 
 ### Prepare the content
@@ -65,7 +69,10 @@ Check [Manifest files](migration-manifest.md) to see the detailed requirements.
 
 The `CreateMigrationJob` method creates a migration job, which is queued up for processing. Migration API manages the queue and returns status and logs. Use the `CreateMigrationEncrypted` method to migrate encrypted contents. Check [SharePoint Migration API Reference](migration-api-reference.md) for details.
 
-Upon creation of a new migration job, Migration API returns the Job ID. Track the status of the import with the `GetMigrationJobStatus` method if needed, with the Azure Queue supplied.
+> [!IMPORTANT]
+> Use GetMigrationJobProgress API to track migration job status.
+
+Upon creation of a new migration job, Migration API returns the Job ID. Track the status of the import with [GetMigrationJobProgress API](migration-job-progress-api-reference.md).
 
 Migration API generates logs in the manifest container. Check the log entries for migration results.
 

docs/apis/migration-api-reference.md

@@ -1,7 +1,7 @@
 ---
 title: "SharePoint Migration API Reference Guide"
 description: "This article provides in-depth information on how to use the SharePoint Migration API."
-ms.date: 04/28/2024
+ms.date: 07/16/2025
 ms.author: ranren
 author: underreview
 manager: dapodean
@@ -172,6 +172,9 @@ See Return value in `CreateMigrationJob` method.
 
 ## GetMigrationJobStatus method
 
+> [!IMPORTANT]
+> Use [GetMigrationJobProgress API](migration-job-progress-api-reference.md) to retrieve migration job status. Deprecation of GetMigrationJobStatus API is planned for the second half of 2026. Until then, it will remain available for status retrieval.
+
 Retrieves the processing status for a designated migration job.
 
 Migration API removes completed migration jobs from the timer job queue. Check the notification queue and/or log outputs for import results.