Sign in

v1

latestOpenAPI 3.1.02026-07-13570316.1 KB
Authentication

Link Auth

Link an additional authentication method or external wallet to the currently authenticated user. Provide the authentication token from another completed login (for example, a SIWE wallet or OAuth account) and this endpoint will associate it with the user's existing wallet.

Usage:

  1. Complete an authentication flow using /auth/complete to obtain the new authentication token
  2. Call this endpoint with the token you want to link
  3. Receive the full list of linked authentication profiles for the wallet

Authentication: Requires both client authentication (x-client-id or x-secret-key) and a wallet access token via Authorization: Bearer <jwt>.

post/v1/auth/link

Request body

accountAuthTokenToConnectstring required

Authentication token for the account that should be linked to the currently authenticated wallet.

Example request

{
  "accountAuthTokenToConnect": "tw_acc_auth_token_123"
}

Response

Authentication method linked successfully. The response contains the updated list of linked authentication profiles.

Example response

{
  "linkedAccounts": [
    {
      "id": "auth_siwe_123",
      "type": "siwe",
      "walletAddress": "0x742d35Cc6634C0532925a3b8D43C67B8c8B3E9C6"
    }
  ]
}