> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magic.link/llms.txt
> Use this file to discover all available pages before exploring further.

# Migration Guide

> Migrate from Magic Wallet Services (MWS) or Express API v1 to Express API v2.

## Migrating from Express API v1 to v2

* **Apps created before July 31, 2026**: v1 requests are automatically redirected to the v2 endpoint. No immediate action is required, but we recommend updating your codebase to call v2 directly.
* **Apps created after July 31, 2026**: v1 access is banned. You must use v2 endpoints.

The change is minimal — only the URL paths change. All headers and request bodies remain the same. Update `/v1/wallet` to `/v2/wallet` and `/v1/wallet/sign/*` to `/v2/wallet/sign/*`.

## Migrating from MWS (`loginWithOIDC`)

We're deprecating MWS and moving all customers to Express API, which enables wallet operations without an iframe or going through Magic for authentication.

All of your end users' wallets have already been migrated to Express API and new wallets are already being created via the new system. There will be no downtime for you or your end users.

<Steps>
  <Step title="Fetch your Provider ID">
    Retrieve your new provider ID using the following request:

    ```bash cURL icon="square-terminal" theme={null}
    curl -X GET 'https://tee.express.magiclabs.com/v1/identity/provider' \
      -H 'X-Magic-Secret-Key: YOUR_MAGIC_SECRET_KEY'
    ```

    <Info>
      One has already been created for all existing developers. While your existing `providerId` from the `loginWithOIDC` call will work temporarily as the `X-OIDC-Provider-ID` header, the old identifier will be deprecated soon.
    </Info>
  </Step>

  <Step title="Replace loginWithOIDC with the wallet endpoint">
    Update your authentication flow to use the following request instead of `loginWithOIDC` to get or create a wallet:

    ```bash cURL icon="square-terminal" theme={null}
    curl -X POST 'https://tee.express.magiclabs.com/v2/wallet' \
      -H 'Content-Type: application/json' \
      -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
      -H 'X-Magic-API-Key: YOUR_MAGIC_API_KEY' \
      -H 'X-OIDC-Provider-ID: YOUR_OIDC_PROVIDER_ID' \
      -H 'X-Magic-Chain: ETH'
    ```
  </Step>

  <Step title="Update signing operations">
    Replace Magic SDK signing with TEE signing. See the [signing operations](/server-wallets/express-api/wallet-operations#signing-operations) page for detailed implementation, and the data preparation pages for specific chains:

    * [EVM Data Preparation](/server-wallets/express-api/data-preparation/evm)
    * [Solana Data Preparation](/server-wallets/express-api/data-preparation/solana)
  </Step>

  <Step title="Uninstall Magic SDK">
    Remove the `magic-sdk` package and any related extensions from your project:

    <CodeGroup>
      ```bash NPM icon="npm" theme={null}
      npm uninstall magic-sdk @magic-ext/oidc
      ```

      ```bash Yarn icon="yarn" theme={null}
      yarn remove magic-sdk @magic-ext/oidc
      ```
    </CodeGroup>
  </Step>
</Steps>