---
title: "GET /migration.exchange"
method: GET
path: "/migration.exchange"
tags: ["migration"]
---

# GET /migration.exchange

`GET /migration.exchange`

For Enterprise Grid workspaces, map local user IDs to global user IDs

## Query parameters

- `token` string, required
- `users` string, required
- `team_id` string
- `to_old` boolean

## Response `200`

Typical success response when mappings exist for the specified user IDs

- object — Schema for successful response from migration.exchange method
  - `enterprise_id` string, required
  - `invalid_user_ids` string[]
  - `ok` true, required
  - `team_id` string, required
  - `user_id_map` object

## Other responses

- `default` — Typical error response when there are no mappings to provide

---

[API](https://skmtc.net/slack/apis/web-api.md) · [All operations](https://skmtc.net/slack/apis/web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slack/web-api/revisions/7b951462b44f/schema)