Skip to content

cross-tenant migration APIs fixes #9949

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
FaithOmbongi merged 1 commit into from
Jun 24, 2026
Merged

cross-tenant migration APIs fixes #9949

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions api-reference/beta/resources/crosstenant-migration-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Cross-tenant migration API overview
description: Learn about the Microsoft Graph cross-tenant migration API, which enables tenant administrators to migrate user content across Microsoft 365 tenants.
description: Learn about the Microsoft Graph cross-tenant migration API, which enables tenant administrators to migrate user data across Microsoft 365 tenants.
author: danipocket
ms.author: danielabo
ms.date: 11/04/2025
Expand All @@ -12,13 +12,13 @@ doc_type: conceptualPageType

# Cross-tenant migration API overview

The cross-tenant migration API in Microsoft Graph enables tenant administrators to migrate user content from one Microsoft 365 tenant to another. This API provides a unified solution for moving Exchange, Teams, and SharePoint data across tenants, supporting scenarios such as mergers, acquisitions, and organizational restructuring.
The cross-tenant migration API in Microsoft Graph enables tenant administrators to migrate user data from one Microsoft 365 tenant to another. This API provides a unified solution for moving Exchange, Teams, and SharePoint data across tenants, supporting scenarios such as mergers, acquisitions, and organizational restructuring.

## Why use the cross-tenant migration API?

Organizations often need to consolidate or reorganize Microsoft 365 environments. The cross-tenant migration API simplifies this process by allowing admins to:

- Create and manage migration jobs for user or group content.
- Create and manage migration jobs for user or group data.
- Validate configurations before migration.
- Monitor migration progress and troubleshoot issues.
- Cancel or delete migration jobs for compliance purposes.
Expand All @@ -35,7 +35,7 @@ Organizations often need to consolidate or reorganize Microsoft 365 environments
## API status

- **Preview**: Currently available in the `/beta` endpoint.
- **Scope**: User content migration only.
- **Scope**: User data migration only.
- **Limitations**:
- Job names must be unique per tenant.
- Jobs in progress can't be deleted.
Expand Down
Loading