Skip to content

docs(scim): clarify directory sync custom attribute paths#3345

Draft
NicolasLopes7 wants to merge 1 commit intomainfrom
nicolas/scim-directory-sync-attr-paths
Draft

docs(scim): clarify directory sync custom attribute paths#3345
NicolasLopes7 wants to merge 1 commit intomainfrom
nicolas/scim-directory-sync-attr-paths

Conversation

@NicolasLopes7
Copy link
Copy Markdown
Contributor

Summary

Follow-up to #3334. The directory sync guide still advertised the wrong custom extension URN (urn:clerk:scim:schemas:extension:custom:2.0:User) and implied custom attributes only worked through that namespace.

Backend behavior: scim_path resolves any field on the SCIM user payload via gjson — top-level core attributes, nested attributes, or anything under an extension namespace (standard enterprise extension or Clerk's custom extension).

Changes

  • Fixed URN to urn:ietf:params:scim:schemas:extension:clerk:2.0:User.
  • Added a sentence covering top-level / nested / extension-namespace paths.
  • Step example now shows both Clerk and enterprise extension paths.
  • Switched colon to dot for the trailing path component (gjson syntax).

Test plan

  • Render preview, verify formatting of nested bullet list under step 4.

The directory sync guide still advertised the wrong custom extension URN
(urn:clerk:scim:schemas:extension:custom:2.0:User) and implied the
mapping only worked through that namespace. Aligns with #3334: the
backend resolves any SCIM path the IdP sends — top-level, nested, or
under any extension namespace, including the standard enterprise
extension and Clerk's custom extension.
@vercel
Copy link
Copy Markdown

vercel Bot commented May 4, 2026

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

Project Deployment Actions Updated (UTC)
clerk-docs Ready Ready Preview May 4, 2026 9:35pm

Request Review

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.

1 participant