Skip to content

docs(scim): fix custom attribute extension URN#3334

Merged
NicolasLopes7 merged 2 commits into
mainfrom
nicolas/scim-custom-attrs-fix
Apr 30, 2026
Merged

docs(scim): fix custom attribute extension URN#3334
NicolasLopes7 merged 2 commits into
mainfrom
nicolas/scim-custom-attrs-fix

Conversation

@NicolasLopes7
Copy link
Copy Markdown
Contributor

@NicolasLopes7 NicolasLopes7 commented Apr 30, 2026

Summary

The custom attribute mapping guide had two factual errors that I caught while fact-checking against the backend:

  • It advertised a fictional schema extension URN (urn:clerk:scim:schemas:extension:custom:2.0:User). The real URN that /Schemas advertises and that user payloads accept is urn:ietf:params:scim:schemas:extension:clerk:2.0:User.
  • The "SCIM attribute" example told users to enter urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department — which is the standard enterprise extension, not Clerk's. The backend accepts any path the IdP sends (top-level core attribute, nested, or any extension namespace).

This PR:

  • Corrects the URN.
  • Rewrites the example so it shows Clerk's custom extension as the primary path while noting the standard enterprise extension also works.
  • Clarifies that the SCIM path can target a top-level core attribute (e.g. title), a nested attribute (e.g. name.givenName), or any extension namespace.

@NicolasLopes7 NicolasLopes7 requested a review from a team as a code owner April 30, 2026 14:01
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 30, 2026

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

Project Deployment Actions Updated (UTC)
clerk-docs Ready Ready Preview Apr 30, 2026 5:06pm

Request Review

The custom attribute mapping guide advertised a fictional schema URN
(urn:clerk:scim:schemas:extension:custom:2.0:User) and used the standard
enterprise extension in its example path. The backend actually advertises
urn:ietf:params:scim:schemas:extension:clerk:2.0:User and accepts any
SCIM path the IdP sends (top-level, nested, or any extension namespace).
@NicolasLopes7 NicolasLopes7 force-pushed the nicolas/scim-custom-attrs-fix branch from 642fc0d to a7e8d4d Compare April 30, 2026 14:05
@NicolasLopes7 NicolasLopes7 merged commit 2d42714 into main Apr 30, 2026
8 checks passed
@NicolasLopes7 NicolasLopes7 deleted the nicolas/scim-custom-attrs-fix branch April 30, 2026 17:07
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