v1

latestOpenAPI 3.1.0Proprietary2026-07-2265155163.6 KB
Auth

Log in with Privy token

Handles POST /v1/auth/login/privy via post.v1.auth.login.privy.

post/v1/auth/login/privy

Request body

privy_tokenstring required
wallet_pubkeystring nullable

Optional Solana wallet pubkey the caller is asserting ownership of. For first-time bindings ownership must be proved either by including wallet_proof (a Solana memo transaction signed by the wallet — works for Ledger which cannot sign off-chain messages) or, absent a proof, by Privy's linked_accounts API confirming the wallet is linked to the authenticated user. An unverified pubkey is rejected with wallet_not_linked. For returning users, if supplied, it must match the bound pubkey. If omitted when no mapping exists, login still succeeds but the issued token will not carry a wallet claim and so cannot satisfy user-scoped authorization.

Response

Phoenix JWT pair issued

access_tokenstring required
expires_ininteger required
pop_keystring required
refresh_expires_ininteger required
refresh_tokenstring required
token_typestring required