Skip to main content
POST
Admin Dev Auth Token
This endpoint mints a short-lived signed dev-auth token for browser development/testing against local or staging platform-api targets.

Scope

  • Internal-only
  • Disabled for production use
  • Protected by ADMIN_AUTH_SECRET_TOKEN

Request

Headers:
  • Authorization: Bearer <ADMIN_AUTH_SECRET_TOKEN>
  • Content-Type: application/json
Body:
Fields:
  • primaryWallet: required canonical wallet for the synthetic session
  • linkedWallets: optional additional linked wallets
  • userId: optional synthetic user id override
  • vmPreference: optional preferred VM for wallet routing
  • expiresInSeconds: optional TTL override
  • issuer: optional issuer override

Response

Use the returned token as:

Runtime Behavior

platform-api treats accepted dev-auth tokens as wallet-backed sessions for:
  • owner reads
  • wallet routing
  • realtime subscription ticket issuance
  • feature-flag lookups
The token is rejected when:
  • the runtime is production
  • DEV_AUTH_TOKEN_SECRET is unset
  • the token is expired or malformed
  • the wallet claims are invalid