Document migration.* methods and split out their arguments into own f…

…ile.

packages/web-api/src/methods.ts

@@ -246,6 +246,7 @@ import type { ReactionsAddArguments, ReactionsGetArguments, ReactionsListArgumen
 import type { PinsAddArguments, PinsListArguments, PinsRemoveArguments } from './types/request/pins';
 import type { OpenIDConnectTokenArguments, OpenIDConnectUserInfoArguments } from './types/request/openid';
 import type { OAuthAccessArguments, OAuthV2AccessArguments, OAuthV2ExchangeArguments } from './types/request/oauth';
+import type { MigrationExchangeArguments } from './types/request/migration';
 
 /**
  * Generic method definition
@@ -757,6 +758,10 @@ export abstract class Methods extends EventEmitter<WebClientEvent> {
   };
 
   public readonly migration = {
+    /**
+     * @description For Enterprise Grid workspaces, map local user IDs to global user IDs.
+     * @see {@link https://api.slack.com/methods/migration.exchange `migration.exchange` API reference}.
+     */
     exchange: bindApiCall<MigrationExchangeArguments, MigrationExchangeResponse>(this, 'migration.exchange'),
   };
 
@@ -2284,13 +2289,4 @@ export interface FilesRemoteShareArguments extends TokenOverridable {
   external_id?: string;
 }
 
-/*
- * `migration.*`
- */
-// https://api.slack.com/methods/migration.exchange
-export interface MigrationExchangeArguments extends TokenOverridable, OptionalTeamAssignable {
-  users: string; // comma-separated list of users
-  to_old?: boolean;
-}
-
 export * from '@slack/types';

packages/web-api/src/types/request/migration.ts

@@ -0,0 +1,9 @@
+import type { OptionalTeamAssignable, TokenOverridable } from './common';
+
+// https://api.slack.com/methods/migration.exchange
+export interface MigrationExchangeArguments extends TokenOverridable, OptionalTeamAssignable {
+  /** @description A comma-separated list of user IDs, up to 400 per request. */
+  users: string;
+  /** @description Specify `true` to convert `W` global user IDs to workspace-specific `U` IDs. Defaults to `false`. */
+  to_old?: boolean;
+}