ESC
Type to search...

CrossTenantContentMigration.ReadWrite.All

Export JSON
Export CSV
Copy URL
Print
ApplicationDelegated Read/Write All Resources

Allows the app to read and write your tenant's all cross tenant content migration job details without a signed-in user.

In short

CrossTenantContentMigration.ReadWrite.All is available as both an application permission and a delegated permission in the Microsoft Graph API, grouped under the CrossTenantContentMigration category. Allows the app to read and write your tenant's all cross tenant content migration job details without a signed-in user. It grants read and write access to resources. Application permissions always require admin consent.

Permission data: November 17, 2026 at 3:06 AM UTC
Delegated Access App-Only Access

Permission Details

Application Permission

Read and write all cross tenant content migration job details

Allows the app to read and write your tenant's all cross tenant content migration job details without a signed-in user.

Delegated Permission Admin consent required

Read and write all cross tenant content migration job details

Allows the app to read and write your tenant's all cross tenant content migration job details on behalf of the signed-in user.

Properties

Microsoft Graph v1.0 endpoint-derived-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property Type Description
completeAfterDateTime DateTimeOffset Date and time after which the migration should be performed. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z.
createdBy String User principal name (UPN) of the user who created the job. Read-only.
createdDateTime DateTimeOffset When the job was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z. Read-only.
displayName String Display name of the job. Must be unique per tenant.
exchangeSettings exchangeOnlineCrossTenantMigrationSettings Settings to use for migration of Exchange workload. Nullable.
id String Unique identifier for the migration job. Read-only. Inherited from entity.
jobType crossTenantMigrationJobType Type of the migration job. The possible values are: validate (only validation is performed, no migration), migrate (content is migrated), and unknownFutureValue.
lastUpdatedDateTime DateTimeOffset When this migration job was last updated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z. Read-only.
message StringNullable Status message of the migration job. Nullable. Read-only.
resources String collection IDs (GUID) of the resources that are migrated with the migration job.
resourceType String Type of resource being migrated. Only Users is currently supported.
sourceTenantId String ID (GUID) of the source tenant for the content migration.
status crossTenantMigrationJobStatus Most recent status of the migration job. Read-only. The possible values are: submitted, approved, processing, cuttingOver, inProgress, completed, completedWithErrors, failed, cancelled, pendingCancel, adminActionRequired, validateSubmitted, validateProcessing, validateInProgress, validatePassed, validateFailed, pendingDelete, deleted, unknownFutureValue.
targetTenantId String ID of the target tenant for the content migration. Read-only.
workloads String collection Workloads to migrate. Supported workloads are Teams, Exchange, and ODSP (OneDrive/SharePoint).

Showing 15 of 16 properties.

JSON Representation

Microsoft Graph v1.0 endpoint-derived-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation
{
  "@odata.type": "#microsoft.graph.crossTenantMigrationJob",
  "id": "String (identifier)",
  "displayName": "String",
  "jobType": "String",
  "sourceTenantId": "String",
  "targetTenantId": "String",
  "completeAfterDateTime": "String (timestamp)",
  "status": "String",
  "message": "String",
  "createdDateTime": "String (timestamp)",
  "createdBy": "String",
  "lastUpdatedDateTime": "String (timestamp)",
  "exchangeSettings": {
    "@odata.type": "microsoft.graph.exchangeOnlineCrossTenantMigrationSettings"
  },
  "workloads": [
    "String"
  ],
  "resourceType": "String",
  "resources": [
    "String"
  ]
}

Relationships

Microsoft Graph v1.0 endpoint-derived-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship Type Description
users crossTenantMigrationTask collection Details and status of the users migrated in this migration job.
jobType crossTenantMigrationJobType Related jobType data exposed by this resource.
resources string collection IDs (GUID) of the resources that are migrated with the migration job.
status crossTenantMigrationJobStatus Related status data exposed by this resource.
workloads string collection Workloads to migrate. Supported workloads are Teams, Exchange, and ODSP (OneDrive/SharePoint).

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /solutions/migrations/crossTenantMigrationJobs
GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users
GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users/{crossTenantMigrationTaskId}
POST /solutions/migrations/crossTenantMigrationJobs
POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/cancel
POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/migrate
POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users/{crossTenantMigrationTaskId}/cancel
POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/validate
PATCH /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
DELETE /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /solutions/migrations/crossTenantMigrationJobs
GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users
GET /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users/{crossTenantMigrationTaskId}
POST /solutions/migrations/crossTenantMigrationJobs
POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/cancel
POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/migrate
POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users/{crossTenantMigrationTaskId}/cancel
POST /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/validate
PATCH /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
DELETE /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgBetaCrossTenantMigrationJob /solutions/migrations/crossTenantMigrationJobs
List crossTenantMigrationJobs
Get-MgBetaCrossTenantMigrationJob /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
Get crossTenantMigrationJob
Get-MgBetaCrossTenantMigrationJobUser /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users
List crossTenantMigrationTask objects
Get-MgBetaCrossTenantMigrationJobUser /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/users/{crossTenantMigrationTaskId}
Get crossTenantMigrationTask
New-MgBetaCrossTenantMigrationJob /solutions/migrations/crossTenantMigrationJobs
Create crossTenantMigrationJob
Remove-MgBetaCrossTenantMigrationJob /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
Delete crossTenantMigrationJob
Test-MgBetaCrossTenantMigrationJob /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}/validate
crossTenantMigrationJob: validate
Update-MgBetaCrossTenantMigrationJob /solutions/migrations/crossTenantMigrationJobs/{crossTenantMigrationJobId}
Update crossTenantMigrationJob

Code Examples

C# / .NET SDK
Create crossTenantMigrationJob
// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new CrossTenantMigrationJob
{
	DisplayName = "xtmigration_user_req_1",
	CompleteAfterDateTime = DateTimeOffset.Parse("2024-12-09T22:48:03.092Z"),
	SourceTenantId = "12345678-1234-1234-1234-123456789012",
	ExchangeSettings = new ExchangeOnlineCrossTenantMigrationSettings
	{
		TargetDeliveryDomain = "xtmigration.onmicrosoft.com",
		SourceEndpoint = "sampleEndpointText",
	},
	Resources = new List<string>
	{
		"4dd550d9-9ea2-4e71-a16b-60b1d1c4f506",
		"63f15b55-f61a-49cb-a599-2e3d233afb2c",
		"41d94bac-3a53-47d6-a89e-583830104e15",
	},
	ResourceType = "Users",
	Workloads = new List<string>
	{
		"Teams",
		"Exchange",
		"ODSP",
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Solutions.Migrations.CrossTenantMigrationJobs.PostAsync(requestBody);
JavaScript
Create crossTenantMigrationJob
const options = {
	authProvider,
};

const client = Client.init(options);

const crossTenantMigrationJob = {
  displayName: 'xtmigration_user_req_1',
  completeAfterDateTime: '2024-12-09T22:48:03.092Z',
  sourceTenantId: '12345678-1234-1234-1234-123456789012',
  exchangeSettings: {
    targetDeliveryDomain: 'xtmigration.onmicrosoft.com',
    sourceEndpoint: 'sampleEndpointText'
  },
  resources: [
    '4dd550d9-9ea2-4e71-a16b-60b1d1c4f506',
    '63f15b55-f61a-49cb-a599-2e3d233afb2c',
    '41d94bac-3a53-47d6-a89e-583830104e15'
  ],
  resourceType: 'Users',
  workloads: [
    'Teams',
    'Exchange',
    'ODSP'
  ]
};

await client.api('/solutions/migrations/crossTenantMigrationJobs')
	.version('beta')
	.post(crossTenantMigrationJob);
PowerShell
Create crossTenantMigrationJob
Import-Module Microsoft.Graph.Beta.Migrations

$params = @{
	displayName = "xtmigration_user_req_1"
	completeAfterDateTime = [System.DateTime]::Parse("2024-12-09T22:48:03.092Z")
	sourceTenantId = "12345678-1234-1234-1234-123456789012"
	exchangeSettings = @{
		targetDeliveryDomain = "xtmigration.onmicrosoft.com"
		sourceEndpoint = "sampleEndpointText"
	}
	resources = @(
	"4dd550d9-9ea2-4e71-a16b-60b1d1c4f506"
"63f15b55-f61a-49cb-a599-2e3d233afb2c"
"41d94bac-3a53-47d6-a89e-583830104e15"
)
resourceType = "Users"
workloads = @(
"Teams"
"Exchange"
"ODSP"
)
}

New-MgBetaCrossTenantMigrationJob -BodyParameter $params
Python
Create crossTenantMigrationJob
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.cross_tenant_migration_job import CrossTenantMigrationJob
from msgraph_beta.generated.models.exchange_online_cross_tenant_migration_settings import ExchangeOnlineCrossTenantMigrationSettings
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = CrossTenantMigrationJob(
	display_name = "xtmigration_user_req_1",
	complete_after_date_time = "2024-12-09T22:48:03.092Z",
	source_tenant_id = "12345678-1234-1234-1234-123456789012",
	exchange_settings = ExchangeOnlineCrossTenantMigrationSettings(
		target_delivery_domain = "xtmigration.onmicrosoft.com",
		source_endpoint = "sampleEndpointText",
	),
	resources = [
		"4dd550d9-9ea2-4e71-a16b-60b1d1c4f506",
		"63f15b55-f61a-49cb-a599-2e3d233afb2c",
		"41d94bac-3a53-47d6-a89e-583830104e15",
	],
	resource_type = "Users",
	workloads = [
		"Teams",
		"Exchange",
		"ODSP",
	],
)

result = await graph_client.solutions.migrations.cross_tenant_migration_jobs.post(request_body)

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for CrossTenantContentMigration.ReadWrite.All

4

Grant Admin Consent

Application permissions always require admin consent.

Frequently asked questions

What is the CrossTenantContentMigration.ReadWrite.All Microsoft Graph permission?

CrossTenantContentMigration.ReadWrite.All is available as both an application permission and a delegated permission in the Microsoft Graph API, grouped under the CrossTenantContentMigration category. Allows the app to read and write your tenant's all cross tenant content migration job details without a signed-in user. It grants read and write access to resources. Application permissions always require admin consent. It is mapped to the Microsoft Graph crosstenantmigrationjob resource type. 22 documented Microsoft Graph REST methods require it. 8 Microsoft Graph PowerShell commands are documented for it.

Is CrossTenantContentMigration.ReadWrite.All an application or a delegated permission?

CrossTenantContentMigration.ReadWrite.All is available as both an application permission (app-only access, no signed-in user) and a delegated permission (access on behalf of a signed-in user).

Does CrossTenantContentMigration.ReadWrite.All require admin consent?

Application permissions always require admin consent.

What is the permission ID (GUID) for CrossTenantContentMigration.ReadWrite.All?

For CrossTenantContentMigration.ReadWrite.All, the application (app role) ID is c5a29fd1-4629-4f52-8316-4d639ffa95d0, and the delegated (OAuth2 scope) ID is 0569b6eb-c9e3-4dc6-a998-6df963be6689. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.