feat: add Anonymous Sessions documentation#1455
Open
BcnCarlos wants to merge 15 commits into
Open
Conversation
Add five draft articles covering Auth0 Anonymous Sessions under docs/manage-users/sessions/anonymous-sessions and wire them into the Sessions navigation group in manage-users.json. Articles: - anonymous-sessions.mdx — concept overview, workflow, key concepts, session/access token structure, limitations - quickstart.mdx — 5-step setup guide (tenant config, application, API, create session, update metadata) - transfer-to-users.mdx — session token passing, Actions examples (Pre-Registration, Post-Login, cart merge), unsupported flows - claims-mapping.mdx — declarative no-code claims mapping, three use-case examples, limitations - best-practices.mdx — security (JWE, server-side validation, metadata sanitization), performance (caching, batching), implementation patterns Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
Summary
Redirects per inputRedirects in main/docs/manage-users/sessions/anonymous-sessions/quickstart.mdx
|
- Remove forbidden 'This guide…' opening from quickstart. - Replace forbidden 'Follow these best practices…' opening in best-practices with a user-first sentence. - Replace 'client' with 'application' in claims-mapping (two instances). - Add validatedOn: 2026-06-25 to all five article frontmatter blocks. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Rewrite overview opening to lead with user action (user-first). - Replace instruction in Limitations with a link to best-practices (concept docs should not contain how-to instructions). - Fix quickstart title dash to colon: 'Quick Start - …' → 'Quick Start: …'. - Remove 'performant' buzzword from best-practices opening sentence. - Spell out '1 hour' → 'one hour' in code comment (numbers one–nine). - Add sidebarTitle to transfer-to-users and best-practices. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Replace ASCII art with the official sequence diagram image showing the full anonymous session lifecycle (session creation, metadata updates, anonymous purchase, and session token refresh). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…sion-workflow.png
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/manage-users/sessions/anonymous-sessions/manage-users.jsonArticles
anonymous-sessions.mdxanonymous-sessions/quickstart.mdxanonymous-sessions/transfer-to-users.mdxanonymous-sessions/claims-mapping.mdxcustom_claim_mappings, three use-case examples (session ID, personalization, guest checkout), limitationsanonymous-sessions/best-practices.mdxNotes for reviewers
The following items should be validated against the product spec before publishing:
POST /anonymous/tokenandPOST /anonymous/logout— confirm exact pathsanonymous_session_lifetime,anonymous_session_token_format— confirm against Management API speccan_create_anonymous_sessions— confirm spelling matches API specallow_anonymous_access,token_lifetime_for_anonymous_access— confirm against API specTest plan
cd main && mint devand confirm Anonymous Sessions group appears under Sessions in the sidebarmint broken-linkspasses frommain/🤖 Generated with Claude Code