Skip to main content

Upgrade session

POST 
/session/upgrade

Requests additional permissions for the player's session. The response depends on the type of permission requested:

  • PLAYER-managed permissions are enabled immediately. The response includes the updated session with status: "PASS".
  • GUARDIAN-managed permissions create a CHALLENGE_SESSION_UPGRADE challenge for the trusted adult to complete.
  • Permissions with verifiedAgeThreshold create a CHALLENGE_SESSION_UPGRADE_BY_AGE_ASSURANCE challenge. The player must verify their age through AgeKit+ rather than parental consent. All requested permissions must either all have a verifiedAgeThreshold or none of them can — mixing the two types in a single request returns a 400 error.

Once age verification is recorded on the session (via a verified platform signal or a completed age assurance challenge), subsequent upgrade requests for permissions with the same or lower threshold can be satisfied immediately without a new challenge.

Request​

Responses​

Response