---
title: "POST /v1/{+parent}/migrationTokens"
method: POST
path: "/v1/{+parent}/migrationTokens"
tags: ["enterprises"]
---

# POST /v1/{+parent}/migrationTokens

`POST /v1/{+parent}/migrationTokens`

Creates a migration token, to migrate an existing device from being managed by the EMM's Device Policy Controller (DPC) to being managed by the Android Management API. See the guide (https://developers.google.com/android/management/dpc-migration) for more details.

## Path parameters

- `parent` string, required

## Request body

- MigrationToken — A token to initiate the migration of a device from being managed by a third-party DPC to being managed by Android Management API. A migration token is valid only for a single device. See the guide (https://developers.google.com/android/management/dpc-migration) for more details.
  - `policy` string — Required. Immutable. The name of the policy initially applied to the enrolled device, in the form enterprises/{enterprise}/policies/{policy}.
  - `device` string — Output only. Once this migration token is used to migrate a device, the name of the resulting Device resource will be populated here, in the form enterprises/{enterprise}/devices/{device}.
  - `ttl` string, google-duration — Input only. The time that this migration token is valid for. This is input-only, and for returning a migration token the server will populate the expireTime field. This can be at most seven days. The default is seven days.
  - `additionalData` string — Immutable. Optional EMM-specified additional data. Once the device is migrated this will be populated in the migrationAdditionalData field of the Device resource. This must be at most 1024 characters.
  - `value` string — Output only. The value of the migration token.
  - `createTime` string, google-datetime — Output only. Time when this migration token was created.
  - `deviceId` string — Required. Immutable. The id of the device, as in the Play EMM API. This corresponds to the deviceId parameter in Play EMM API's Devices.get (https://developers.google.com/android/work/play/emm-api/v1/devices/get#parameters) call.
  - `userId` string — Required. Immutable. The user id of the Managed Google Play account on the device, as in the Play EMM API. This corresponds to the userId parameter in Play EMM API's Devices.get (https://developers.google.com/android/work/play/emm-api/v1/devices/get#parameters) call.
  - `name` string — Output only. The name of the migration token, which is generated by the server during creation, in the form enterprises/{enterprise}/migrationTokens/{migration_token}.
  - `managementMode` 'MANAGEMENT_MODE_UNSPECIFIED' | 'WORK_PROFILE_PERSONALLY_OWNED' | 'WORK_PROFILE_COMPANY_OWNED' | 'FULLY_MANAGED' — Required. Immutable. The management mode of the device or profile being migrated.
  - `expireTime` string, google-datetime — Immutable. The time when this migration token expires. This can be at most seven days from the time of creation. The migration token is deleted seven days after it expires.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/androidmanagement.md) · [All operations](https://skmtc.net/google/apis/androidmanagement/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/androidmanagement/versions/956638790236/schema)