Skip to content

Document optional SCIM mailNickname fallback - #2071

Merged
Regan Downer (v-regandowner) merged 1 commit into
MicrosoftDocs:mainfrom
chiragm28:docs/scim-mailnickname-fallback
Aug 27, 2026
Merged

Document optional SCIM mailNickname fallback#2071
Regan Downer (v-regandowner) merged 1 commit into
MicrosoftDocs:mainfrom
chiragm28:docs/scim-mailnickname-fallback

Conversation

@chiragm28

@chiragm28 Chirag Mali (chiragm28) commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Mark the Enterprise User and Microsoft Entra User schema extensions as optional in the ResourceTypes examples.
  • Document that mailNickname is optional during user creation and is derived from the portion of userName before the first @ when omitted or empty.
  • Update the create example to demonstrate the fallback and clarify that mailNickname can't be removed after creation.

Validation

  • Verified the article was unchanged from the referenced source commit before editing.
  • Ran git diff --check successfully.

Chirag Mali
Document optional SCIM mailNickname fallback
e438642 
Update User resource discovery and create guidance to describe deriving mailNickname from userName when the Entra extension value is omitted.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 3290af15-80e7-48b0-91b8-f1cee56be1cb
@prmerger-automator

prmerger-automator Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Chirag Mali (@chiragm28) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. Jennifer Fields (@jenniferf-skc)

@prmerger-automator

prmerger-automator Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Chirag Mali (@chiragm28) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. Jennifer Fields (@jenniferf-skc)

@chiragm28
Chirag Mali (chiragm28) marked this pull request as draft August 13, 2026 00:04
@learn-build-service-prod

learn-build-service-prod Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit e438642:

✅ Validation status: passed

File Status Preview URL Details
docs/identity/app-provisioning/entra-id-scim-api-reference.md ✅Succeeded

For more details, please refer to the build report.

@v-regandowner

Regan Downer (v-regandowner) commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Chetan Desai (@cmmdesai)

Can you review the proposed changes?

IMPORTANT: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

cmmdesai
Chetan Desai (cmmdesai) approved these changes Aug 26, 2026
View reviewed changes

@cmmdesai Chetan Desai (cmmdesai) left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved

@cmmdesai

Chetan Desai (cmmdesai) commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

#sign-off

@prmerger-automator

prmerger-automator Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

⚠️ PRMerger: You can't sign off on draft PR

  • You signed off, but this PR is a draft and can't be merged. If you're ready for this PR to be reviewed, select Ready for review toward the bottom of the PR, then sign off again.

@cmmdesai

Chetan Desai (cmmdesai) commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Regan Downer (@v-regandowner) this change is ready for publication. But I don't see an option to convert this draft PR and mark it as ready for review. Chirag Mali (@chiragm28) do you see that option?

@chiragm28
Chirag Mali (chiragm28) marked this pull request as ready for review August 26, 2026 21:06
Copilot AI reviewed Aug 27, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Microsoft Entra ID SCIM API reference to clarify mailNickname behavior during user creation and to reflect that certain schema extensions are optional in ResourceTypes examples.

Changes:

  • Marked the Enterprise User and Microsoft Entra User schema extensions as optional (required: false) in the /resourcetypes example.
  • Documented that mailNickname is optional on create and is derived from userName when omitted, null, or empty; updated the create example accordingly.
  • Clarified that mailNickname can’t be removed after user creation via PATCH.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/identity/app-provisioning/entra-id-scim-api-reference.md
Comment on lines 217 to 222
"schemaExtensions": [
{
"schema": "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User",
"required": true
"required": false
}
],
@v-regandowner
Regan Downer (v-regandowner) merged commit e29fe29 into MicrosoftDocs:main Aug 27, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot
Copilot review effort
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments
+1 more reviewer
@cmmdesai Chetan Desai (cmmdesai) cmmdesai approved these changes
Reviewers whose approvals may not affect merge requirements

Assignees

@cmmdesai Chetan Desai (cmmdesai)

Labels

app-provisioning/subsvc aq-pr-triaged Change sent to author do-not-merge entra-id/svc

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@chiragm28 @v-regandowner @cmmdesai