Merge branch 'main' into user/jsinghmokha/add-section-management-apis-beta

Author: Danipocket

.github/copilot-instructions.md

@@ -127,6 +127,9 @@ configuration:
             When the updates in this PR are ready for external customers to use, please replace the **do not merge** label with **ready to merge**.
 
 
+            If this PR includes schema-related changes, verify that the updates are visible in the metadata endpoint before merging: [https://graph.microsoft.com/beta/$metadata](https://graph.microsoft.com/beta/$metadata) for `beta` changes, or [https://graph.microsoft.com/v1.0/$metadata](https://graph.microsoft.com/v1.0/$metadata) for `v1.0` changes.
+
+
             Check the content review workflow [here](https://eng.ms/cid/27dee76c-3a60-4e65-8fdf-08ea849b3498/fid/3a993b6c9d547e46f59d8d7851f191c38bbbea6ead01253dc62fcdd8101a1ff9).
       - removeLabel:
           label: content review in progress
@@ -1041,15 +1044,6 @@ configuration:
       then:
       - removeLabel:
           label: 'resolved: awaiting prod deployment'
-    - description: Add schema live label when pull request is labeled resolved awaiting prod deployment
-      if:
-      - payloadType: Pull_Request
-      - labelAdded:
-          label: 'resolved: awaiting prod deployment'
-      - isOpen
-      then:
-      - addLabel:
-          label: schema live
     - description: Add do not merge label to new pull requests opened by contributors
       if:
       - payloadType: Pull_Request

.github/policies/resourceManagement.yml

@@ -126,7 +126,8 @@ Create a dedicated topic for the enumeration. This option is rarely applicable.
 
 1. **Create enum topic:**
    - Title: "{enum-type} enum type"
-   - Single sentence describing the enum's purpose
+   - doc_type: "enumPageType"
+   - Single sentence describing the enum's purpose, linking to consuming resource(s)
    - **For flagged enums:** Append "This flagged enumeration allows multiple members to be selected simultaneously." to the introductory text.
    - **For evolvable enums:** Mention it's an evolvable enumeration
 

.github/prompts/author-api-docs/enumerations.md

@@ -0,0 +1,42 @@
+# Agent Quick Guide
+
+Top-level entrypoint for agents working in this repository.
+
+## Authority
+
+If this file and `.github/copilot-instructions.md` ever differ, follow:
+
+1. `.github/copilot-instructions.md`
+2. The prompt and template files it routes you to
+
+This file is intentionally thin to avoid split-brain guidance.
+
+## Read first
+
+Before doing docs work in this repo:
+
+1. Read `.github/copilot-instructions.md`
+2. Determine whether the task is **authoring/updating** or **review**
+3. Load the prompt file that `.github/copilot-instructions.md` tells you to read first
+
+## Repo map
+
+- `api-reference/*/api/` — API operation topics
+- `api-reference/*/resources/` — resource and enum topics
+- `changelog/` — API change records
+- `concepts/whats-new-overview.md` — monthly release highlights
+- `concepts/` — conceptual topics such as tutorials, conceptual overviews, guides
+- `api-reference/*/toc/toc.mapping.json` — API reference TOC mapping
+- `api-reference/*/includes/rbac-for-apis/` — RBAC include files
+- `temp-docstubs/` — temporary authoring inputs
+
+## Workflow
+
+1. Start with `.github/copilot-instructions.md`
+2. Load the correct scenario guidance
+3. Make scoped changes only
+4. Run the validation expected by the loaded workflow
+
+## Rule of thumb
+
+Do not duplicate detailed rules in this file. Keep detailed authoring, review, changelog, What's New, TOC, enum, and RBAC guidance in the files referenced by `.github/copilot-instructions.md`.

AGENTS.md

@@ -42,13 +42,7 @@ The following table shows the parameters that can be used with this function.
 
 |Parameter|Type|Description|
 |:---|:---|:---|
-|on|[accessPackageAssignmentRequestFilterByCurrentUserOptions](../resources/accesspackageassignmentrequest-accesspackageassignmentrequestfilterbycurrentuseroptions.md)|The list of current user options that can be used to filter on the access package assignment requests list. The possible values are `target`, `createdBy`, `approver`.|
-
-- `target` is used to get the `accessPackageAssignmentRequest` objects where the signed-in user is the target. The resulting list includes all the assignment requests, current and expired, that were requested by the caller or for the caller, across all catalogs and access packages.
-
-- `createdBy` is used to get the `accessPackageAssignmentRequest` objects created by the signed-in user. The resulting list includes all of the assignment requests that the caller has created for themselves or on behalf of others, such as in case of admin direct assignment, across all catalogs and access packages.
-
-- `approver` is used to get the `accessPackageAssignmentRequest` objects where the signed-in user is an allowed approver in any contained `accessPackageAssignment/accessPackageAssignmentPolicy/requestApprovalSettings/approvalStages` (`primaryApprovers` or `escalationApprovers`). The resulting list includes the assignment requests in *pending* state, across all catalogs and access packages and that need a decision from the caller. The resulting list includes the assignment requests in a `pending` state, across all catalogs and access packages and that need a decision from the caller.
+|on|[accessPackageAssignmentRequestFilterByCurrentUserOptions](../resources/accesspackageassignmentrequestfilterbycurrentuseroptions.md)|The list of current user options that can be used to filter on the access package assignment requests list.|
 
 ## Request headers
 |Name|Description|

api-reference/beta/api/accesspackageassignmentrequest-filterbycurrentuser.md

@@ -38,7 +38,7 @@ POST /servicePrincipals/microsoft.graph.agentIdentity
 | Content-Type | application/json. Required. |
 
 ## Request body
-In the request body, supply a JSON representation of a [agentIdentity](../resources/agentidentity.md) object. The request body must contain  **displayName**, **agentIdentityBlueprintAppId**, and a valid **sponsor** reference.
+In the request body, supply a JSON representation of a [agentIdentity](../resources/agentidentity.md) object. The request body must contain  **displayName**, **agentIdentityBlueprintId**, and a valid **sponsor** reference.
 
 ## Response
 
@@ -82,9 +82,9 @@ Content-type: application/json
     "@odata.type": "#microsoft.graph.agentIdentity",
     "id": "59e617e5-e447-4adc-8b88-00af644d7c92",
     "createdByAppId": "f98c895e-6ce2-4f5b-a31b-da7e48f25daa",
-    "displayName": "My Agent Identit",
+    "displayName": "My Agent Identity",
     "servicePrincipalType": "ServiceIdentity",
     "tags": [],
     "agentIdentityBlueprintId": "65415bb1-9267-4313-bbf5-ae259732ee12"
 }
-```
+```

api-reference/beta/api/agentidentity-post.md

@@ -71,10 +71,30 @@ The following example shows a request.
 DELETE https://graph.microsoft.com/beta/users/{usersId}/sponsors/{id}/$ref
 ```
 
+# [C#](#tab/csharp)
+[!INCLUDE [sample-code](../includes/snippets/csharp/delete-sponsors-from-agentuser-csharp-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Go](#tab/go)
+[!INCLUDE [sample-code](../includes/snippets/go/delete-sponsors-from-agentuser-go-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Java](#tab/java)
+[!INCLUDE [sample-code](../includes/snippets/java/delete-sponsors-from-agentuser-java-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
 # [JavaScript](#tab/javascript)
 [!INCLUDE [sample-code](../includes/snippets/javascript/delete-sponsors-from-agentuser-javascript-snippets.md)]
 [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
 
+# [PHP](#tab/php)
+[!INCLUDE [sample-code](../includes/snippets/php/delete-sponsors-from-agentuser-php-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Python](#tab/python)
+[!INCLUDE [sample-code](../includes/snippets/python/delete-sponsors-from-agentuser-python-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
 ---
 
 ### Response

api-reference/beta/api/agentuser-delete-sponsors.md

@@ -77,10 +77,30 @@ Content-Type: application/json
 }
 ```
 
+# [C#](#tab/csharp)
+[!INCLUDE [sample-code](../includes/snippets/csharp/create-sponsor-agentuser-csharp-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Go](#tab/go)
+[!INCLUDE [sample-code](../includes/snippets/go/create-sponsor-agentuser-go-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Java](#tab/java)
+[!INCLUDE [sample-code](../includes/snippets/java/create-sponsor-agentuser-java-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
 # [JavaScript](#tab/javascript)
 [!INCLUDE [sample-code](../includes/snippets/javascript/create-sponsor-agentuser-javascript-snippets.md)]
 [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
 
+# [PHP](#tab/php)
+[!INCLUDE [sample-code](../includes/snippets/php/create-sponsor-agentuser-php-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Python](#tab/python)
+[!INCLUDE [sample-code](../includes/snippets/python/create-sponsor-agentuser-python-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
 ---
 
 ### Response

api-reference/beta/api/agentuser-post-sponsors.md

@@ -142,6 +142,7 @@ Content-type: application/json
         "social"
     ],
     "publisher": "LinkedIn",
+    "deprecationDate": "2027-12-31",
     "description": "LinkedIn Lookup is the easiest way to find coworkers and teams at your company. Lookup is a new people search tool that combines employees' LinkedIn profile information and Active Directory information, allowing you to quickly find and contact your coworkers, on desktop or mobile. Requires an existing Lookup company subscription.",
     "endpoints": [
         "linkedin.com",

api-reference/beta/api/applicationtemplate-get.md

@@ -147,6 +147,7 @@ Content-type: application/json
                 "social"
             ],
             "publisher": "LinkedIn",
+            "deprecationDate": null,
             "description": "LinkedIn Lookup is the easiest way to find coworkers and teams at your company. Lookup is a new people search tool that combines employees' LinkedIn profile information and Active Directory information, allowing you to quickly find and contact your coworkers, on desktop or mobile. Requires an existing Lookup company subscription.",
             "endpoints": [
                 "linkedin.com",