v1

latestOpenAPI 3.1.02026-07-13570316.1 KB
Authentication

Unlink Auth

Disconnect an authentication method or external wallet from the currently authenticated user. Provide the identifiers for the provider you want to remove (for example, an email address or wallet address) and this endpoint will detach it from the user's account.

Usage:

  1. Choose the provider type you want to disconnect (email, phone, siwe, oauth, etc.)
  2. Supply the provider-specific identifiers in the request body
  3. Receive the updated list of linked authentication profiles

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

post/v1/auth/unlink

Request body

type'apple' | 'coinbase' | 'discord' | 'email' | 'facebook' | 'farcaster' | 'github' | 'google' | 'guest' | 'line' | 'passkey' | 'phone' | 'siwe' | 'steam' | 'telegram' | 'twitch' | 'x' | 'tiktok' | 'epic' | 'backend' | 'wallet' | 'custom_auth_endpoint' | 'custom_jwt' required

Authentication provider type to disconnect

allowAccountDeletionboolean

If true, allows the account to be deleted when unlinking removes the last authentication method. Defaults to false when omitted.

Example request

{
  "type": "siwe",
  "details": {
    "address": "0x742d35Cc6634C0532925a3b8D43C67B8c8B3E9C6"
  }
}

Response

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

Example response

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