Skip to content

Conversation

@jfoshee
Copy link
Contributor

@jfoshee jfoshee commented Feb 3, 2026

🔎 Previews:

What does this solve?

  • The API was previously updated to return an id_token.
  • The documentation for the getUserOauthAccessToken() SDK function did not explicitly mention that the OIDC ID Token (id_token) is also returned when available. (It's not obvious from the function name.) This update clarifies the full return value of the function.

What changed?

  • Added a new "Returns" section to docs/reference/backend/user/get-user-oauth-access-token.mdx.
  • Documented all properties of the OauthAccessToken object, including the idToken? field.
  • The idToken? documentation specifies that it contains the user's OIDC ID Token (JWT) when the provider supports OIDC, and notes that it may be undefined for other providers.
  • Included a link to the OIDC overview for additional context.

Open in Cursor Open in Web

Document that the user's OIDC ID Token (id_token) is also returned when
available from the getUserOauthAccessToken() SDK function. Added a Returns
section documenting all OauthAccessToken properties, with the idToken field
noting that not all OAuth providers implement OIDC.

Co-authored-by: jacob.foshee <[email protected]>
@cursor
Copy link

cursor bot commented Feb 3, 2026

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

@vercel
Copy link

vercel bot commented Feb 3, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clerk-docs Ready Ready Preview Feb 3, 2026 10:15pm

Request Review

Remove the #openid-connect-oidc anchor that wasn't being found due to
how headings with parentheses are slugified. Link to the overview page
directly instead.

Co-authored-by: jacob.foshee <[email protected]>
@jfoshee jfoshee marked this pull request as ready for review February 3, 2026 17:51
@jfoshee jfoshee requested a review from a team as a code owner February 3, 2026 17:51
Include all properties from the OauthAccessToken class:
- publicMetadata: metadata readable from Frontend/Backend API
- label: descriptive label for multiple tokens of same provider
- expiresAt: Unix timestamp when token expires

Also reordered properties to match the class definition order.

Co-authored-by: jacob.foshee <[email protected]>
@SarahSoutoul
Copy link
Contributor

I've pushed everything now, and happy with where this is at. @alexisintech you may want to have a look at this for final approval?

@jfoshee
Copy link
Contributor Author

jfoshee commented Feb 3, 2026

Thanks @SarahSoutoul! This is much cleaner!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants