Skip to content

Repo sync for protected branch - #10084

Merged
learn-build-service-prod[bot] merged 46 commits into
mainfrom
main639289177912419612sync_temp
Oct 30, 2026
Merged

learn-build-service-prod[bot] merged 46 commits into
mainfrom
main639289177912419612sync_temp

Conversation

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build Service tried pushing to main, but failed due to branch protection rule in this branch. We create this pull request for manual merge. Please merge this pull request to complete this sync.
If you want to make push successfully without creating such pull requests in future, please follow working with branch protection rule to update your branch protection rule.

snippet-gen-pull-automation Bot and others added 30 commits October 23, 2026 12:04
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
* Update known issue for RBAC in Places APIs

Clarified role assignment requirements for delegated access and application permissions.

* Update known issue for RBAC in Places APIs

Clarified role assignment requirements for delegated access and application permissions in Microsoft Entra ID.

* Update whats-new-overview.md

---------

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
* docs: Fix beta mailbox folder delete URLs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: e27a98af-146a-4c6c-a536-f2802fc50568

* docs: Fix v1.0 mailbox folder delete URLs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: e27a98af-146a-4c6c-a536-f2802fc50568

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Copilot-Session: e27a98af-146a-4c6c-a536-f2802fc50568
…ions /beta (#29755)

* Add API documentation for roleManagementCustomCalloutExtension operations

- Created endpoints for managing roleManagementCustomCalloutExtension objects:
  - DELETE /identityGovernance/privilegedAccess/customExtensions/{roleManagementCustomCalloutExtensionId}
  - GET /identityGovernance/privilegedAccess/customExtensions
  - POST /identityGovernance/privilegedAccess/customExtensions
  - PATCH /identityGovernance/privilegedAccess/customExtensions/{roleManagementCustomCalloutExtensionId}

- Added resource type documentation for roleManagementCustomCalloutExtension and unifiedRoleManagementPolicyCustomExtensionRule.
- Included permissions tables for each operation.
- Updated RBAC and permissions references for custom extensions in Privileged Identity Management.

* Add customCalloutExtensionType and customExtensionResourceType enumerations to roleManagementCustomCalloutExtension

* Remove response name fields from custom extension API documentation

* Update Authorization header format in API documentation for custom extensions

* Update authenticationConfiguration description for clarity

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Enhance role management with new resource types and methods

Added new resource types and methods for role management and custom extensions in Privileged Identity Management. Enhanced capabilities for integrating workflows and managing role assignment evaluations.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Fix inherited v1.0 changelog links on PIM beta branch

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 7011d5cb-ee8d-4206-8f87-5b2157139f0c

* Update reference TOC

* Update parameter types in custom extension API documentation

* Preserve PIM review fixes from pre-rebase merge commit

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 7011d5cb-ee8d-4206-8f87-5b2157139f0c

* Match PIM beta action link labels to API titles

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 7011d5cb-ee8d-4206-8f87-5b2157139f0c

---------

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Copilot-Session: 7011d5cb-ee8d-4206-8f87-5b2157139f0c
* Add Tenant Governance refresh status v1.0 docs

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

* Address refresh status review feedback

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

* Fix refresh status response annotation

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

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

---------

Co-authored-by: Akhil Potturi <potturiakhil@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Co-authored-by: David1997sb <26681210+David1997sb@users.noreply.github.com>
Co-authored-by: David1997sb <salasbar97@gmail.com>
* docs: Document group mailboxId in beta

Add the select-only mailboxId property, Get group example, changelog record, and What's New entry for PR 17077105.

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

Copilot-Session: 25fbd1fd-1e34-447b-9e83-fe81a9753bde

* Update group-get.md

* Update group.md

* Apply suggestion from @JarbasHorst

* Update whats-new-overview.md

* Update Microsoft.Exchange.json

* Apply suggestion from @JarbasHorst

---------

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Copilot-Session: 25fbd1fd-1e34-447b-9e83-fe81a9753bde
…nt (beta) (#29537)

* Document beta PICS pre-classified file metadata

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Rename classic sensitive contents documentation

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Rename sensitive content classification snapshots

Align the beta resource pages, TOC, changelog, and What's New entry with the approved singular classification-snapshot contract names.

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

Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Document reused classification wrapper and classifiedContentDateTime

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

Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Use classificationDateTime in classification wrapper docs

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

Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Reduce processContent docs to caller-supplied sensitivity labels

Keep only the optional nullable currentSensitivityLabel input on beta
processFileMetadata, reusing currentLabel and its existing applicationMode.
Document UploadFile label precedence, fallback, validation, and app gating.
Remove preclassification-only resources, fields, navigation and release notes
from the cumulative PR scope while preserving baseline documentation.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Address currentLabel documentation review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Reconcile canonical PICS docs with approved shared label collection

Preserve the existing PR's unrelated documentation and reviewer fixes.
Document inherited sensitivityLabels, no-reset guidance, supported
activities, and validated one-label/two-label processContent examples.
Keep the original changelog review date pending public beta publication.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Address Reeza's sensitivity-label documentation suggestions

Refresh the changelog review date, explain the caller capability in what's new, and introduce currentLabel through its consuming collection.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Document unknownFutureValue for processContent applicationMode

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Add release notes for applicationMode unknownFutureValue

Address Reeza October14 feedback on PR29537. Cover the beta enum addition in changelog and Whats New and refresh the review date. Keep schema rollout and publication holds unchanged.

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

Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Add generated v1.0 changelog for processContent labels

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

* Fix currentLabel v1 changelog link before docs publication

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d

---------

Co-authored-by: Jiajun Zhang <jiajunzhang@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: David1997sb <26681210+David1997sb@users.noreply.github.com>
Copilot-Session: 12b1df5a-1ef9-4d3d-a6f7-97f96a803e7d
* Document secure agent DLP beta APIs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 97706116-b32b-4999-8db8-fb1f00d1587c

* Fix Secure Agent API Doctor validation

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

Copilot-Session: 97706116-b32b-4999-8db8-fb1f00d1587c

* Update agent category documentation examples

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

Copilot-Session: 2b869777-ea3b-49db-a77d-0d3e98c80ee2

* Address latest content review comments

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

* Update reference TOC

* Update reference TOC

* Fix stale policy location link

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

Copilot-Session: ea37eef7-e721-4d05-82bb-d4768e605a5e

* Add redirect for policy location tool

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

* Remove hidden audit activities documentation

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

Copilot-Session: 6788c577-1065-4924-bdd1-07b77c2abe76

* Address Secure Agent DLP documentation review feedback

Add effective policy configuration to the agent scope response, move the announcement to security, and refresh the changelog date.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: f294a3c3-1d44-487f-bde6-b329debe9f74

---------

Co-authored-by: Pratik Sanyal (from Dev Box) <pratiksanyal@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Copilot-Session: 97706116-b32b-4999-8db8-fb1f00d1587c
Copilot-Session: 2b869777-ea3b-49db-a77d-0d3e98c80ee2
Copilot-Session: ea37eef7-e721-4d05-82bb-d4768e605a5e
Copilot-Session: 6788c577-1065-4924-bdd1-07b77c2abe76
Copilot-Session: 731379c5-e5ac-4511-85bd-b28a88657e1f
Copilot-Session: f294a3c3-1d44-487f-bde6-b329debe9f74
* Document app management audit public preview

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

* Address app management audit review feedback

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

* Fix app management audit author metadata

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

* Add app management audit complex type to TOC

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

* Align dictionary type casing with beta schema

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

* Qualify Dictionary type references

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

* Address app management audit review feedback

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

* Update reference TOC

* Update app management audit publication metadata

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

---------

Co-authored-by: Yucel Kivanc <yucelkivanc@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: yclkvnc <8520861+yclkvnc@users.noreply.github.com>
Co-authored-by: David1997sb <26681210+David1997sb@users.noreply.github.com>
* Document approverDelegate API for public preview

Add Get/Update (PUT) API topics for /me/identityGovernance/approverDelegate
and /users/{user-id}/identityGovernance/approverDelegate, permissions
includes, TOC placement under Identity Governance, changelog, and What's New.

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

* Clarify approverDelegate permission and role requirements

Note that EntitlementManagement permissions require admin consent even on
the /me path, and that the Identity Governance Administrator role gates
access to other users' delegates.

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

* Align approverDelegate changelog with repo conventions and surface methods on user

Use en-us Learn URLs without preserve-view in changelog descriptions, use
sentence-form ChangedApiName for CRUD methods, and add an Identity
governance group to the user resource Methods table.

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

* Fix duplicate changelog entries and author metadata

The approverDelegate and identityGovernanceUserSettings resources and the
user.identityGovernance property were already logged in
changelog/Microsoft.IGAELM.json on main. Revert the duplicate record from
Microsoft.IdentityGovernance.AccessReviews.json and log only the two new
methods in Microsoft.IGAELM.json, matching the workload area used for the
rest of this feature.

Also set author to corey284 on the two newly created API topics.

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

* Address review feedback on approverDelegate docs

- Fix Authorization header rows that contained literal asterisks instead of
  the standard Bearer token placeholder.
- Move Entra role guidance out of inline NOTEs into two RBAC include files
  following templates/rbac-for-apis-include.md, keeping the caveat that no
  directory role is needed for your own delegate.
- Remove the inaccurate 'Automatically generated' front matter from the two
  permissions includes, matching the bare-table shape used elsewhere. The
  permission values remain unverified pending service registration.
- Refresh ms.date, drop the redundant truncation note, and note in the
  resource topic why there's no delete operation.

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

* Restore API Doctor request-response pairing

Keep unique names on request annotations and use unnamed response annotations so API Doctor associates each response with the preceding request.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 63a362d9-75c7-43c8-a3ea-cbd04b278936

* Match approverDelegate method labels to API titles

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 63a362d9-75c7-43c8-a3ea-cbd04b278936

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Copilot-Session: 63a362d9-75c7-43c8-a3ea-cbd04b278936
Auto Publish – main to live - 2026-10-24 00:30 UTC
…ope) (#29549)

* Add beta docs for access reviews catalog scope (accessReviewCatalogScope)

Documents the accessReviewCatalogScope resource and accessReviewCatalogResourceType enumeration, which enter public preview on /beta. Includes changelog and What's New entries.

* Address content review feedback on accessReviewCatalogScope docs

Adds accessReviewCatalogScope to toc.mapping.json under Access reviews as a complex type, adds the What's New bullet marker, links the enum-valued properties to their enum anchors, and fixes the code fence and section spacing.

* Update reference TOC

* Apply suggestion from @Danipocket

* Refresh catalog scope changelog date per review

Use the author-confirmed October 14, 2026 review date.

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

* Fix catalog scope changelog link validation

Link to the new resource page without a fragment so the validator recognizes its unpublished-page exemption.

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

* Refresh catalog scope changelog date

---------

Co-authored-by: RajaDinesh Kumar Murugesan <ramurug@microsoft.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: Danipocket <88507770+Danipocket@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Auto Publish – main to live - 2026-10-27 00:30 UTC
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
* docs: clarify case management comment length limits

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3684cf00-7e54-499a-bb0c-23fdac546735

* Update whats-new-overview.md

* Update whats-new-overview.md

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Copilot-Session: 3684cf00-7e54-499a-bb0c-23fdac546735
Remove extra space

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
* docs: Document objectConnections public beta (api-reference/beta/resources/synchronization-objectconnection.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Document objectConnections public beta (api-reference/beta/resources/synchronization-synchronizationjob.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Document objectConnections public beta (api-reference/beta/api/synchronization-objectconnection-get.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Document objectConnections public beta (api-reference/beta/api/synchronization-synchronizationjob-delete-objectconnections.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Document objectConnections public beta (api-reference/beta/includes/permissions/synchronization-objectconnection-get-permissions.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Document objectConnections public beta (api-reference/beta/includes/permissions/synchronization-synchronizationjob-delete-objectconnections-permissions.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Document objectConnections public beta (changelog/Microsoft.IAM.json)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Document objectConnections public beta (concepts/whats-new-overview.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Document objectConnections public beta (api-reference/beta/toc/toc.mapping.json)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Fix objectConnections validation and regenerate permissions (synchronization-objectconnection-get.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Fix objectConnections validation and regenerate permissions (synchronization-synchronizationjob-delete-objectconnections.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Fix objectConnections validation and regenerate permissions (synchronization-synchronization.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Fix objectConnections validation and regenerate permissions (synchronization-objectconnection-get-permissions.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Fix objectConnections validation and regenerate permissions (synchronization-synchronizationjob-delete-objectconnections-permissions.md)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Make OData type annotation optional and clarify GET permissions

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Make OData type annotation optional and clarify GET permissions

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: Align synchronization resource with public beta CSDL

Remove the internal version property and document the existing entity inheritance and id key, verified against https://graph.microsoft.com/beta/$metadata. Clarify that the objectConnection changelog announcement includes associated methods.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* docs: clarify object connection identifiers and add management guide

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

Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* Update reference TOC

* docs: restore synchronization TOC under applications in beta

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

Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339

* Update reference TOC

* Update whats-new-overview.md

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Madison Panzarella <mpanzarella@microsoft.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Copilot-Session: 3ba8ce60-71ac-4dd9-a06a-809645593339
* Add Cloud PC managed license operations

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

* Fix changelog links for unpublished Cloud PC docs

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

* Merge duplicate Cloud PC release highlights after rebase

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

* Fix Cloud PC managed license response annotations

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

* Update cloudpcmanagedlicense-submitmanagedlicenseoperation.md

* Update cloudpcmanagedlicense-retrievemanagedlicenseoperation.md

* Update description for cloudPcManagedLicense operation

Clarify the derived type in the operation description.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Update documentation on operation request ID handling

Clarify the consequences of losing the '202 Accepted' response and provide guidance for administrators.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Change ApiChange type from Resource to ComplexType

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Update deprecation date and add multi-user license support

Updated the deprecation date for certain image properties to December 7, 2026, and clarified that no replacement is planned for recommendedSku. Added support for extending Windows 365 Reserve access for multiple users with the submitManagedLicenseOperation action.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Apply suggestion from @JarbasHorst

* Update cloudpcmanagedlicense.md

* Update reference TOC

* Remove name field from managed license operation responses

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Update cloudpcmanagedlicenseextendaccess.md

* Update cloudpcmanagedlicenseoperation.md

* Update cloudpcmanagedlicenseoperationresult.md

* Update cloudpcmanagedlicenseextendaccess.md

* Update Microsoft.CloudManagedDesktop.json

* Update whats-new-overview.md

* Update cloudpcmanagedlicenseextendaccess.md

---------

Co-authored-by: Huijun Jin (from Dev Box) <huijunjin@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: guptadiksha_microsoft <guptadiksha@microsoft.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: David1997sb <26681210+David1997sb@users.noreply.github.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: promote Enhanced Restore policy scope to v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* docs: Retain restore point protection unit filter

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

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Enhance restore session resources with policyId

Added the policyId property to multiple restore session resources and updated the search method to include a policyId parameter.

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Apply suggestion from @JarbasHorst

* Update restorepoint-search.md

* Update restoresessionbase.md

* Update backuprestoreroot-list-restorepoints.md

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Update Microsoft.EnhancedRestore.json

* docs: Clarify policy validation on restore sessions

Apply the content review feedback to derived SharePoint, OneDrive for Business, and Exchange restore-session resources in beta and v1.0.

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

Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab

* Update whats-new-overview.md

* Update CreatedDateTime and add WorkloadArea fields

* Update promoted v1.0 ms.date values

Co-authored-by: agarwal-arjun <8549133+agarwal-arjun@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Co-authored-by: arjunagarwal <arjunagarwal+odspmdb@microsoft.com>
Co-authored-by: Aditi Gangwar <108422131+AdiGanMSFT@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Copilot-Session: d69ece22-2943-437b-b025-c1c8000c27ab
* Add CA policy plan documentation stubs

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

* Set CA policy plan subservice metadata

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

* Set CA policy plan documentation author

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

* Correct CA policy plan permissions

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

* Complete CA policy plan reference content

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

* Polish CA policy plan documentation

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

* Address CA policy plan review feedback

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

* Address Conditional Access content review

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

* Address follow-up Conditional Access review

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

---------

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
* docs: draft beta SLA policy CRUD reference

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

* Clarify immutable SLA policy display names

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

* Align SLA policy @odata.type docs with PPE

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

* docs: address SLA policy review feedback

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

* Fix SLA policy type references

Fully qualify case management subnamespace types for API Doctor and align the documented collection query options with the approved API contract.

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

* docs: specify SLA policy query support and simplify type links

Document per-property filter operators and sort directions, clarify combined query options and parent relationship expansion, and shorten type-link labels as requested in PR review.

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

* docs: restore qualified table types for API Doctor

Restore namespace-qualified Type and Return type cells required by API Doctor. Preserve short prose links, query-support documentation, link targets, and JSON examples.

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

* docs: address SLA query and RBAC review feedback

Remove the per-property query matrix and repeated filter annotations as requested by Alex. Simplify case SLA status wording and remove the ignored-write promise. Add separate SLA read and configuration-management RBAC includes, preserving shared notes for other APIs.

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

* docs: specify verified SLA policy filter and sort support

Document scalar property filter operators and sort directions on the list page, with a relationship cross-reference. Keep the details compact without restoring the query matrix.

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

* docs: fix SLA page dates and least-privileged RBAC guidance

Use MM/DD/YYYY dates on the twelve new API/resource pages and update the SLA RBAC includes to the reviewed least-privilege wording.

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

* docs: simplify SLA policy query guidance

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

* docs: remove unrelated line-ending changes

Restore files from main that were normalized while resolving the merge.

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

* Fix SLA query-support cross-reference

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

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Celeste de Guzman <16906646+CelesteDG@users.noreply.github.com>
Auto Publish – main to live - 2026-10-28 00:30 UTC
* Promote PIM group resource API to v1.0

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

* Update reference TOC

* Add PIM group resource to What's New

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

* Refresh PIM group resource changelog date

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

* Address final PIM docs review feedback

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

---------

Co-authored-by: Mandar Dalvi <madalvi@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Danipocket <88507770+Danipocket@users.noreply.github.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: David1997sb <26681210+David1997sb@users.noreply.github.com>
Co-authored-by: David1997sb <salasbar97@gmail.com>
learn-build-service-prod Bot and others added 16 commits October 29, 2026 00:35
Auto Publish – main to live - 2026-10-29 00:30 UTC
* Document identity verification events configuration

* Address content review feedback

* Address identity verification events review suggestions

Clarify stored defaults versus PATCH omission, refresh the changelog publication date, and reuse the existing What's New heading.

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

* Update whats-new-overview.md

---------

Co-authored-by: Tim Larson <tilarso@microsoft.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Co-authored-by: David1997sb <26681210+David1997sb@users.noreply.github.com>
…… (#29768)

* docs: add isEnabled property and new enum members to roleManagementCustomCalloutExtension

* Fix unpublished PIM changelog links using published parent resources

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 7011d5cb-ee8d-4206-8f87-5b2157139f0c

* docs: add isEnabled property and new enum members to roleManagementCustomCalloutExtension

* Fix unpublished PIM changelog links using published parent resources

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 7011d5cb-ee8d-4206-8f87-5b2157139f0c

---------

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: CelesteDG <16906646+CelesteDG@users.noreply.github.com>
Copilot-Session: 7011d5cb-ee8d-4206-8f87-5b2157139f0c
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
* Document Cloud PC Key Vault domain join credentials

* Restored the original examples and all SDK tabs on the create and update pages

* Fix documentation author metadata

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

* Fix changelog links for new Cloud PC resources

* Restore ID placeholders in existing Cloud PC request examples

* Rename cloudpconpremisesconnectionsubnetIpdetail.md to cloudpconpremisesconnectionsubnetipdetail.md

* Fix Cloud PC documentation link casing, changelog types, response metadata, and legacy request credentials.

* Fix Cloud PC subnet detail link casing to match the renamed topic

* Update Microsoft.CloudManagedDesktop.json

* Update virtualendpoint-post-onpremisesconnections.md

* Update cloudpconpremisesconnection-update.md

* Update cloudpconpremisesconnection-updateaddomainpassword.md

* Update virtualendpoint-post-onpremisesconnections.md

* Update cloudpconpremisesconnection-update.md

* Update cloudpcdomainjoincredential.md

* Update cloudpconpremisesconnection-update.md

* Update cloudpconpremisesconnection-updateaddomainpassword.md

* Update virtualendpoint-post-onpremisesconnections.md

* Update cloudpcdomainjoinkeyvaultintentconfiguration.md

* Update cloudpcdomainjoinkeyvaultpasswordconfiguration.md

* Update cloudpcdomainjoinplaintextuseridentity.md

* Update cloudpcdomainjoinuseridentity.md

* Update cloudpckeyvaultdomainjoincredential.md

* Update cloudpconpremisesconnection.md

* Update cloudpcplaintextdomainjoincredential.md

* Update cloudpconpremisesconnectionhealthcheckerrortype.md

* Apply suggestion from @JarbasHorst

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Apply suggestion from @JarbasHorst

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Update cloudpconpremisesconnection-update.md

* Update virtualendpoint-post-onpremisesconnections.md

* Fix typo in hybrid Microsoft Entra join connection

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Update Microsoft.CloudManagedDesktop.json

---------

Co-authored-by: Bo Zhang <bzhan@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: David1997sb <26681210+David1997sb@users.noreply.github.com>
* Add v1.0 docs for federatedTokenValidationPolicy API

Add documentation for promoting federatedTokenValidationPolicy from beta to v1.0:

New resource docs:
- federatedtokenvalidationpolicy.md
- validatingdomains.md
- alldomains.md
- enumerateddomains.md

New API operation docs:
- GET /policies/federatedTokenValidationPolicy
- PUT /policies/federatedTokenValidationPolicy
- List federatedTokenValidationPolicy

Supporting files:
- Permissions includes (3 files)
- RBAC include for required Entra roles
- Changelog entry for Microsoft.DirectoryServices

Updated existing files:
- policyroot.md: added federatedTokenValidationPolicy relationship
- policy-overview.md: added federatedTokenValidationPolicy row
- enums.md: added rootDomains enum values
- toc.mapping.json: added to Policies section

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

* Fix FTVP v1.0 docs to match approved API surface (singleton, PATCH, add Delete)

federatedTokenValidationPolicy is a singleton (single-valued nav property
on policyRoot, not a collection). Align v1.0 docs with the API.md approved
in Review PR #15484044:

Removed (singleton has no list operation):
- api/policyroot-list-federatedtokenvalidationpolicy.md
- includes/permissions/policyroot-list-federatedtokenvalidationpolicy-permissions.md

Added (matches DELETE scenario in API.md):
- api/federatedtokenvalidationpolicy-delete.md (DELETE, returns 204)
- includes/permissions/federatedtokenvalidationpolicy-delete-permissions.md

Fixed:
- federatedtokenvalidationpolicy-update.md: HTTP verb PUT -> PATCH;
  response 200 OK with body -> 204 No Content (per API.md scenario 2).
- federatedtokenvalidationpolicy.md: Methods table now Get / Update / Delete
  (no List). Update and Delete return type set to None (204).
- federatedtokenvalidationpolicy-get-permissions.md: populated with
  Policy.Read.All (least) / Policy.ReadWrite.AuthenticationFlows (higher).
- federatedtokenvalidationpolicy-update-permissions.md: populated with
  Policy.ReadWrite.AuthenticationFlows.

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

* Fix tab group errors: remove single-tab syntax from API docs

Tab groups require at least two tab headers. Removed the single
HTTP tab header and closing --- marker from three API doc files.

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

* Align FTVP v1.0 docs with backend: drop Delete, use Policy.ReadWrite.FedTokenValidation, fix reviewer comments

Backend reality changes (verified against AD-MSODS-Core master
FederatedTokenValidationPolicyClassHandler.cs and PermissionScopes.xml):

* The handler returns HTTP 405 (MethodNotAllowedException) for POST
  and DELETE; only GET and PATCH are accepted.
* The AAD Graph backend gates FTVP on the scope
  Policy.ReadWrite.FedTokenValidation (TaskSet ebb65174); the previously
  documented Policy.ReadWrite.AuthenticationFlows has no FTVP TaskSet
  binding and would be rejected at runtime.

Doc changes
-----------

Delete operation removed (backend returns 405):
* Delete api-reference/v1.0/api/federatedtokenvalidationpolicy-delete.md
* Delete api-reference/v1.0/includes/permissions/federatedtokenvalidationpolicy-delete-permissions.md
* Remove the Delete row from the Methods table on
  federatedtokenvalidationpolicy.md. Reset semantics are now achieved by
  PATCHing validatingDomains to {"@odata.type":"#microsoft.graph.allDomains",
  "rootDomains":"all"} (the default).

Permission scope corrected:
* federatedtokenvalidationpolicy-get-permissions.md: higher-privileged
  permission changed from Policy.ReadWrite.AuthenticationFlows to
  Policy.ReadWrite.FedTokenValidation (delegated work + application).
* federatedtokenvalidationpolicy-update-permissions.md: least-privileged
  permission changed from Policy.ReadWrite.AuthenticationFlows to
  Policy.ReadWrite.FedTokenValidation (delegated work + application).

Reviewer comments addressed on PR #28573:
* federatedtokenvalidationpolicy-get.md: remove the spurious "value": { ... }
  wrapper from the response example (singletons return the entity directly,
  not as a collection element).
* validatingdomains.md, alldomains.md, enumerateddomains.md: add a "Used as
  the type of the **validatingDomains** property on
  [federatedTokenValidationPolicy]" sentence so each complex type page has
  a clear back-link to its parent resource.
* concepts/whats-new-overview.md: add an FTVP entry under
  "March 2026: New and generally available" -> "Identity and access |
  Identity and sign-in".

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

* FTVP v1.0: clarify @odata.type requirement on validatingDomains

Backed by manual testing against the AAD Graph backend:

* PATCH with rootDomains=enumerated or allManagedAndEnumeratedFederated
  returns HTTP 400 Bad Request unless validatingDomains carries
  @odata.type = #microsoft.graph.enumeratedDomains. The backend cannot
  infer the subtype unambiguously when domainNames must be supplied.
* For the other rootDomains values (none, all, allFederated, allManaged)
  the backend infers the allDomains subtype, so @odata.type is optional.

Changes
-------

* federatedtokenvalidationpolicy-update.md: replace the single-line
  @odata.type note with an [!IMPORTANT] callout that documents both the
  required-cases set and the HTTP 400 failure mode.
* federatedtokenvalidationpolicy.md (resource page JSON representation):
  swap the abstract microsoft.graph.validatingDomains stub for the
  concrete #microsoft.graph.allDomains default state, so the example is
  a valid payload shape.

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

* FTVP v1.0: drop hash prefix from @odata.type and trim guidance phrasing

* Remove the leading '#' from every @odata.type annotation across the
  FTVP v1.0 surface (request/response examples and resource-page JSON
  representations) so the doc matches the form the backend accepts.
* Drop the '- but specifying it explicitly is recommended for clarity'
  trailing recommendation from the [!IMPORTANT] callout in the update
  doc; the callout now states the requirement and stops there.

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

* FTVP v1.0: keep hash prefix on @odata.type in resource pages and GET response

Revert the hash-prefix removal in:
  * federatedtokenvalidationpolicy-get.md
  * federatedtokenvalidationpolicy.md (resource page)
  * validatingdomains.md, alldomains.md, enumerateddomains.md

Those are OData spec-compliant payload examples, not customer copy-paste
targets.

Keep the hash prefix removed in federatedtokenvalidationpolicy-update.md
(both the [!IMPORTANT] callout prose and the PATCH request body example),
because customers copy that payload as-is and the AAD Graph backend has
been verified to accept the non-hash form. Avoids confusing 400-class
errors if a customer pastes the example verbatim.

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

* FTVP v1.0: adopt reviewer-suggested wording for complex-type backlinks

The earlier 'Used as the type of the validatingDomains property...'
phrasing satisfied review rule 14 (backlink present) but discarded the
per-subtype semantics that msewaweru's PR #28573 review suggested.
Replace with the exact wording from each inline comment so the threads
can be resolved as 'fixed per suggestion':

* alldomains.md: '...returns this type when all domains are validated.'
* enumerateddomains.md: '...returns this type when specific domains
   are enumerated for validation.'
* validatingdomains.md: '...uses this type.'

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

* FTVP v1.0: tighten allDomains/enumeratedDomains accuracy

Description sentence
--------------------
* alldomains.md said 'returns this type when all domains are validated',
  which only holds for rootDomains=all. The subtype actually covers four
  non-enumerated modes (none, all, allFederated, allManaged), including
  'none' which validates nothing. Replace with wording that names the
  exact accepted enum values.
* enumerateddomains.md description tightened to name the two accepted
  values (enumerated, allManagedAndEnumeratedFederated).

rootDomains property row
------------------------
Both subtype docs listed all seven base-type enum values, suggesting
the schema-level union rather than the per-subtype reality. A customer
following those tables could construct payloads like
{ @odata.type: enumeratedDomains, rootDomains: all } that the AAD Graph
backend rejects with HTTP 400. Split the value list per subtype:

* allDomains accepts: none, all, allFederated, allManaged,
  unknownFutureValue.
* enumeratedDomains accepts: enumerated, allManagedAndEnumeratedFederated,
  unknownFutureValue.

Each row also points the reader to the sibling subtype for the values
they just excluded.

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

* docs: address federated token validation policy feedback

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

* fix: resolve merge conflicts in changelog and whats-new-overview

* Address review comments on federatedTokenValidationPolicy docs

- update.md: add leading '#' to @odata.type discriminator values in the
  request body and the IMPORTANT note (#microsoft.graph.enumeratedDomains).
- resources.md: JSON representation uses type signatures only - the abstract
  validatingDomains type with "rootDomains": "String" instead of concrete
  allDomains/"all" example values.
- toc.mapping.json: list validatingDomains, allDomains, and enumeratedDomains
  under a complexTypes array in the Policies node so they surface in the TOC.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 693fb168-b248-446a-b0ee-9f3dbd267685

* Use PUT instead of PATCH for v1.0 federatedTokenValidationPolicy update

PATCH on a tenant with no existing federatedTokenValidationPolicy returns HTTP 500 because the singleton doesn't exist yet. PUT upserts (creates on first write, replaces thereafter), so it works on fresh tenants. This also aligns the v1.0 page with the beta page, which already documents PUT. The 200 OK response body is sourced from the validated GET example.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 693fb168-b248-446a-b0ee-9f3dbd267685

* Align v1.0 rootDomains none description with beta (PR #29374)

Ports the expanded 'none' value description from the beta validatingDomains topic to v1.0, per review feedback from @vimrang. The v1.0-specific '(default)' marker on 'all' is preserved.

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

Copilot-Session: 3cb69f6b-56e5-42b1-abb7-6f3797beed17

* Apply suggestion from @Danipocket

* Address follow-up feedback on federated token policy docs

Preserve the author-confirmed changelog-entry date (2026-10-28), including its existing time and precision.

Link the rootDomains enum in all three affected resources.

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

---------

Co-authored-by: Yun Yi <yunyi@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Vimala Ranganathan <vranganathan@microsoft.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: yunyi-sde <yunyi-sde@users.noreply.github.com>
Co-authored-by: Danipocket <88507770+Danipocket@users.noreply.github.com>
Copilot-Session: 693fb168-b248-446a-b0ee-9f3dbd267685
Copilot-Session: 3cb69f6b-56e5-42b1-abb7-6f3797beed17
* Promote attendanceRecord engagement data to v1.0

Adds the meetingEngagement resource type, the meetingEngagementType
enumeration, and the engagements property on attendanceRecord to the
v1.0 endpoint. Updates List attendanceRecords examples, TOC mapping,
changelog, and What's New.

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

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Update whats-new-overview.md

* Update whats-new-overview.md

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
* Document cross-tenant migration APIs in v1.0

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

* Update crosstenantmigrationjob-get.md

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Update crosstenantmigrationjob-list-users.md

* Update crosstenantmigrationjob-list-users.md

* Update crosstenantmigrationjob-update.md

* Update crosstenantmigrationjob-update.md

* Update crosstenantmigrationjob-cancel.md

* Update crosstenantmigrationjob-cancel.md

* Update crosstenantmigrationtask-cancel.md

* Update crosstenantmigrationtask-cancel.md

* Update crosstenantmigrationtask-get.md

* Update crosstenantmigrationtask-get.md

* Update migrationsroot-delete-crosstenantmigrationjobs.md

* Update migrationsroot-delete-crosstenantmigrationjobs.md

* Update migrationsroot-list-crosstenantmigrationjobs.md

* Update migrationsroot-list-crosstenantmigrationjobs.md

* Update migrationsroot-post-crosstenantmigrationjobs.md

* Update migrationsroot-post-crosstenantmigrationjobs.md

* Update migrationsroot-post-crosstenantmigrationjobs.md

* Update migrationsroot-post-crosstenantmigrationjobs.md

* Update migrationsroot-post-crosstenantmigrationjobs.md

* Update migrationsroot-post-crosstenantmigrationjobs.md

* Update migrationsroot-list-crosstenantmigrationjobs.md

* Update migrationsroot-list-crosstenantmigrationjobs.md

* Update crosstenantmigrationjob-update.md

* Update crosstenantmigrationjob.md

* Update crosstenant-migration-overview.md

* Update crosstenant-migration-overview.md

* Update crosstenantmigrationjob.md

* Update crosstenantmigrationservicestatusdetails.md

* Update crosstenantmigrationservicestatusdetails.md

* Update crosstenantmigrationtask.md

* Update crosstenantmigrationtask.md

* Update error.md

* Update error.md

* Update exchangeonlinecrosstenantmigrationsettings.md

* Update migrationsroot.md

* Update migrationsroot.md

* Update migrationsroot.md

* Create .openpublishing.redirection.2026-10.json

* Rename crosstenant migration overview file

* Rename crosstenant-migration-overview.md to crosstenant-migration-api-overview.md

* Update whats-new-overview.md

* Update whats-new-overview.md

* Update Microsoft.Cross.Tenant.Migration.json

* Enhance property descriptions in crosstenantmigrationtask.md

Updated descriptions for properties in crossTenantMigrationTask.

* Update crosstenantmigrationtask.md

* Update crosstenantmigrationjob.md

* Update crosstenantmigrationjob.md

* Update crosstenantmigrationjob.md

* Update toc.mapping.json

* Update toc.mapping.json

* Update and rename crossTenantMigrationCancelResponse.md to crosstenantmigrationcancelresponse.md

* Update .openpublishing.redirection.2026-10.json

* Update api-reference/v1.0/api/crosstenantmigrationjob-update.md

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Update api-reference/v1.0/api/crosstenantmigrationjob-update.md

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Clarify migration cancellation response description

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

Copilot-Session: e0bc61e1-0224-43a3-bed6-d41d66cdf492

* Align cross-tenant migration availability wording

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

Copilot-Session: e0bc61e1-0224-43a3-bed6-d41d66cdf492

* Clarify completeAfterDateTime behavior

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

Copilot-Session: e0bc61e1-0224-43a3-bed6-d41d66cdf492

* Align beta migration task description

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

Copilot-Session: e0bc61e1-0224-43a3-bed6-d41d66cdf492

* Document CTMS OData query support

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

Copilot-Session: e0bc61e1-0224-43a3-bed6-d41d66cdf492

* Complete CTMS permission documentation

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

Copilot-Session: e0bc61e1-0224-43a3-bed6-d41d66cdf492

* Update crosstenantmigrationjob-update.md

* Update crosstenantmigrationjob-update.md

* Update crosstenantmigrationjob-list-users.md

* Update crosstenantmigrationjob-list-users.md

* Update crosstenantmigrationtask-get.md

* Update crosstenantmigrationtask-get.md

* Update migrationsroot-list-crosstenantmigrationjobs.md

* Update migrationsroot-list-crosstenantmigrationjobs.md

* Update crosstenantmigrationjob.md

* Document v1.0 solutions migration relationship

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

* Add solutionsRoot resource changelog entry

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

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

---------

Co-authored-by: rebeccawwood <29644648+rebeccawwood@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: David1997sb <26681210+David1997sb@users.noreply.github.com>
Copilot-Session: e0bc61e1-0224-43a3-bed6-d41d66cdf492
…#29778)

* Document telecom provider settings

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

Copilot-Session: 7875cd25-7900-43a7-8ba5-7704b8d117fa

* Keep authentication examples additive

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

Copilot-Session: 7875cd25-7900-43a7-8ba5-7704b8d117fa

* Fix unpublished changelog link

Co-authored-by: janexingms <296623908+janexingms@users.noreply.github.com>

---------

Co-authored-by: Jane Xing <janexing@microsoft.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: David1997sb <26681210+David1997sb@users.noreply.github.com>
Copilot-Session: 7875cd25-7900-43a7-8ba5-7704b8d117fa
* Document billed aggregated usage export in v1.0

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

* Fix API documentation links in changelog

Updated links in descriptions to point to the correct version of the API documentation.

* Update changelog record and add billed aggregated usage attribute schema

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

* Fix API Doctor example annotations

Co-authored-by: tingh-msft <191419652+tingh-msft@users.noreply.github.com>

* Update partners-billing-billedaggregatedusage-export.md

* Update partners-billing-billedaggregatedusage-export.md

* Update whats-new-overview.md

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Fix link to billedAggregatedUsage in documentation

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Update reference TOC

---------

Co-authored-by: tingh <tingh@microsoft.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: David1997sb <26681210+David1997sb@users.noreply.github.com>
* docs: document final custom emoji schema

* docs: fix custom emoji metadata validation

* docs: correct custom emoji binary examples

* Use bearer token in custom emoji auth headers

Co-authored-by: JarbasHorst <26866873+JarbasHorst@users.noreply.github.com>

* Update teamworkmessaging-post-customemojis.md

* Apply suggestion from @JarbasHorst

* Apply suggestion from @JarbasHorst

* docs: address custom emoji review feedback

* Update reference TOC

* Update Microsoft.Teams.GraphSvc.json

* Update teamworkcustomemoji-get.md

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Update whats-new-overview.md

* docs: move custom emoji update to September preview

* Update teamworkcustomemoji-delete-permissions.md

* Update teamworkcustomemoji-get-permissions.md

* Apply suggestion from @JarbasHorst

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Apply batched suggestions from code review

Co-authored-by: Jarbas Horst <26866873+JarbasHorst@users.noreply.github.com>

* Update teamworkcustomemoji-get.md

* Update teamworkmessaging-list-customemojis.md

* Update teamworkmessaging-post-customemojis.md

* Update teamworkmessaging-post-customemojis.md

* Update whats-new-overview.md

* Update teamworkmessaging-post-customemojis.md

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: JarbasHorst <26866873+JarbasHorst@users.noreply.github.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: David1997sb <26681210+David1997sb@users.noreply.github.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>
Auto Publish – main to live - 2026-10-30 00:30 UTC
@learn-build-service-prod

Copy link
Copy Markdown
Contributor Author

Learn Build status updates of commit f9505c7:

✅ Validation status: passed

For more details, please refer to the build report.

@learn-build-service-prod
learn-build-service-prod Bot merged commit a693031 into main Oct 30, 2026
10 checks passed
@learn-build-service-prod
learn-build-service-prod Bot deleted the main639289177912419612sync_temp branch October 30, 2026 00:43
@github-actions github-actions Bot added this to the Community Contributions milestone Oct 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.