Skip to content

Token types

This describes the types of tokens issued by Mosaic, how to obtain them, and other usage details.

TokensUsed toObtainedConsumed byDefault TTL
ID tokensIdentify users and get their profile dataReturned upon user authenticationApp1 hour
User access tokensGrant user access to your app or authorize Mosaic actions that require a logged-in userReturned upon user authenticationApp and Mosaic1 hour
Client access tokensAuthorize app-level management actions (magic link auth, updating user profiles, etc.)Generated using end-user app client credsMosaic1 hour
Admin access tokensAuthorize backend services to perform tenant-level management actions (retrieving all users, etc.)Generated using management app client credsMosaic1 hour
Refresh tokensRenew expired tokens for offline accessReturned upon user authenticationMosaic14 days
Reset tokensReset passwordsReturned when user authenticates for a reset flowMosaic5 min
Notes
  • Access token and refresh token time-to-live can be customized by creating resources.
  • All tokens are JWT, except for refresh tokens.
  • You can only refresh ID and user access tokens. See guide.