Skip to content

Commit baaf70a

Browse files
DanipocketDanipocket
authored
Merge pull request #27798 from microsoftgraph/main
Merge to publish.
2 parents 4ea935a + 33d38f8 commit baaf70a

File tree

109 files changed

+4778
-214
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

109 files changed

+4778
-214
lines changed

‎api-reference/beta/api/accesspackagesuggestions-filterbycurrentuser.md‎

Lines changed: 199 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,199 @@
1+
---
2+
title: "accessPackageSuggestions: filterByCurrentUser"
3+
description: "Retrieve suggested access packages for the current end user based on various criteria including related people insights."
4+
ms.localizationpriority: medium
5+
author: "myra-ramdenbourg"
6+
ms.subservice: "entra-id-governance"
7+
doc_type: "apiPageType"
8+
ms.date: 09/18/2025
9+
---
10+
11+
# accessPackageSuggestions: filterByCurrentUser
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Retrieve suggested [accessPackageSuggestion](../resources/accesspackagesuggestion.md) objects for the current end user. This operation returns access packages that are suggested based on various criteria such as related people insights and the user's assignment history.
18+
19+
The suggestions help end users discover relevant access packages they may need for their role or work context.
20+
21+
## Permissions
22+
23+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
24+
25+
<!-- { "blockType": "permissions", "name": "accesspackagesuggestions_filterbycurrentuser" } -->
26+
[!INCLUDE [permissions-table](../includes/permissions/accesspackagesuggestions-filterbycurrentuser-permissions.md)]
27+
28+
## HTTP request
29+
30+
<!-- { "blockType": "ignored" } -->
31+
32+
```http
33+
GET /identityGovernance/entitlementManagement/accessPackageSuggestions/filterByCurrentUser(on={on})
34+
```
35+
36+
## Function parameters
37+
38+
In the request URL, provide the following query parameters with values.
39+
40+
| Parameter | Type |Description|
41+
|:-------------|:-------|:----------|
42+
|on|accessPackageSuggestionFilterByCurrentUserOptions|Filter to determine which suggestions to return. The possible values are: `all`, `assignmentHistory`, `relatedPeopleAssignments`, `unknownFutureValue`.|
43+
44+
## Request headers
45+
46+
| Name |Description|
47+
|:----------|:----------|
48+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
49+
50+
## Request body
51+
52+
Don't supply a request body for this method.
53+
54+
## Response
55+
56+
If successful, this method returns a `200 OK` response code and a collection of [accessPackageSuggestion](../resources/accesspackagesuggestion.md) objects in the response body.
57+
58+
## Examples
59+
60+
### Example 1: Get all access package suggestions with default insight types
61+
62+
#### Request
63+
64+
The following example shows a request.
65+
66+
<!-- {
67+
"blockType": "request",
68+
"name": "accesspackagesuggestions_filterbycurrentuser_all"
69+
}-->
70+
71+
```msgraph-interactive
72+
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageSuggestions/filterByCurrentUser(on='all')?$expand=availableAccessPackage
73+
```
74+
75+
76+
#### Response
77+
78+
The following example shows the response.
79+
80+
> **Note:** The response object shown here might be shortened for readability.
81+
82+
<!-- {
83+
"blockType": "response",
84+
"truncated": true,
85+
"@odata.type": "Collection(microsoft.graph.accessPackageSuggestion)"
86+
} -->
87+
88+
```http
89+
HTTP/1.1 200 OK
90+
Content-type: application/json
91+
92+
{
93+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/accessPackageSuggestions/filterByCurrentUser(on='all')",
94+
"value": [
95+
{
96+
"id": "51b4bd29-cb2d-ef11-8b5f-20c19bd3bce6",
97+
"reasons": [
98+
{
99+
"@odata.type": "#microsoft.graph.accessPackageSuggestionRelatedPeopleBased",
100+
"relatedPeopleAssignmentCount": 2
101+
},
102+
{
103+
"@odata.type": "#microsoft.graph.accessPackageSuggestionSelfAssignmentHistoryBased",
104+
"pastAssignmentCount": 2,
105+
"lastAssignmentDateTime": "2024-08-08T19:13:50.023-07:00"
106+
}
107+
],
108+
"accessPackage": {
109+
"id": "51b4bd29-cb2d-ef11-8b5f-20c19bd3bce6",
110+
"displayName": "ap_discoverable",
111+
"description": "Discoverable package"
112+
}
113+
},
114+
{
115+
"id": "fa6338d0-d12d-ef11-8b5f-20c19bd3bce6",
116+
"reasons": [
117+
{
118+
"@odata.type": "#microsoft.graph.accessPackageSuggestionRelatedPeopleBased",
119+
"relatedPeopleAssignmentCount": 3
120+
}
121+
],
122+
"accessPackage": {
123+
"id": "fa6338d0-d12d-ef11-8b5f-20c19bd3bce6",
124+
"displayName": "ap_allMembers",
125+
"description": "package with all members"
126+
}
127+
}
128+
]
129+
}
130+
```
131+
132+
### Example 2: Get access package suggestions based on assignment history
133+
134+
#### Request
135+
136+
The following example shows a request.
137+
138+
<!-- {
139+
"blockType": "request",
140+
"name": "accesspackagesuggestions_filterbycurrentuser_history"
141+
}-->
142+
143+
```msgraph-interactive
144+
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageSuggestions/filterByCurrentUser(on='assignmentHistory')?$expand=availableAccessPackage
145+
```
146+
147+
148+
#### Response
149+
150+
The following example shows the response.
151+
152+
> **Note:** The response object shown here might be shortened for readability.
153+
154+
<!-- {
155+
"blockType": "response",
156+
"truncated": true,
157+
"@odata.type": "Collection(microsoft.graph.accessPackageSuggestion)"
158+
} -->
159+
160+
```http
161+
HTTP/1.1 200 OK
162+
Content-type: application/json
163+
164+
{
165+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/accessPackageSuggestions/filterByCurrentUser(on='assignmentHistory')",
166+
"value": [
167+
{
168+
"id": "97ce41d0-fc5c-4e10-a979-1ad18e8242d7",
169+
"reasons": [
170+
{
171+
"@odata.type": "#microsoft.graph.accessPackageSuggestionSelfAssignmentHistoryBased",
172+
"pastAssignmentCount": 3,
173+
"lastAssignmentDateTime": "2024-11-28T01:28:15.313Z"
174+
}
175+
],
176+
"accessPackage": {
177+
"id": "97ce41d0-fc5c-4e10-a979-1ad18e8242d7",
178+
"displayName": "ap_allDirectoryUsers",
179+
"description": "All directory users"
180+
}
181+
},
182+
{
183+
"id": "8a14d3a6-32d0-4681-bbcc-a307d247ed3c",
184+
"reasons": [
185+
{
186+
"@odata.type": "#microsoft.graph.accessPackageSuggestionSelfAssignmentHistoryBased",
187+
"pastAssignmentCount": 2,
188+
"lastAssignmentDateTime": "2024-11-28T01:08:51.667Z"
189+
}
190+
],
191+
"accessPackage": {
192+
"id": "8a14d3a6-32d0-4681-bbcc-a307d247ed3c",
193+
"displayName": "8/1 first",
194+
"description": "desc"
195+
}
196+
}
197+
]
198+
}
199+
```

‎api-reference/beta/api/activitiescontainer-post-contentactivities.md‎

Lines changed: 27 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,33 @@ Content-Type: application/json
8888
"sequenceNumber": 0,
8989
"isTruncated": false,
9090
"createdDateTime": "2025-05-27T17:23:20",
91-
"modifiedDateTime": "2025-05-27T17:23:20"
91+
"modifiedDateTime": "2025-05-27T17:23:20",
92+
"agents": [
93+
{
94+
"identifier": "b262a092-6a2b-4682-9c7f-00baf80dbd84",
95+
"name": "Copilot Agent",
96+
"version": "1.2",
97+
"blueprintId": "c262a092-6a2b-4682-9c7f-00baf80dbd94"
98+
}
99+
],
100+
"plugins": [
101+
{
102+
"identifier": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
103+
"name": "Microsoft Purview Data Scanner",
104+
"version": "1.1"
105+
}
106+
],
107+
"accessedResources_v2": [
108+
{
109+
"identifier": "3f2d6e5b-98d4-4f2a-9a61-45c0a8b7d123",
110+
"name": "Report.xlsx",
111+
"url": "https://contoso.sharepoint.com/sites/finance",
112+
"labelId": "a7b4f8c9-1e2d-4f45-89b1-23456789abcd",
113+
"accessType": "read",
114+
"status": "success",
115+
"isCrossPromptInjectionDetected": false
116+
}
117+
]
92118
}
93119
],
94120
"activityMetadata": {

‎api-reference/beta/api/availableaccesspackage-list-resourcerolescopes.md‎

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
---
2+
title: "List resourceRoleScopes"
3+
description: "Retrieve the resource role scopes for an available access package to provide resource details to end users."
4+
ms.localizationpriority: medium
5+
author: "myra-ramdenbourg"
6+
ms.subservice: "entra-id-governance"
7+
doc_type: "apiPageType"
8+
ms.date: 09/18/2025
9+
---
10+
11+
# List resourceRoleScopes
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get a list of the [accessPackageResourceRoleScope](../resources/accesspackageresourcerolescope.md) objects associated with an [availableAccessPackage](../resources/availableaccesspackage.md).
18+
19+
## Permissions
20+
21+
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
22+
23+
<!-- { "blockType": "permissions", "name": "availableaccesspackage_list_resourcerolescopes" } -->
24+
[!INCLUDE [permissions-table](../includes/permissions/availableaccesspackage-list-resourcerolescopes-permissions.md)]
25+
26+
## HTTP request
27+
28+
<!-- { "blockType": "ignored" } -->
29+
30+
```http
31+
GET /identityGovernance/entitlementManagement/availableAccessPackages/{availableAccessPackage-id}/resourceRoleScopes
32+
```
33+
34+
## Optional query parameters
35+
36+
This method supports the `$select`, `$expand`, `$filter`, and `$top` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
37+
38+
## Request headers
39+
40+
| Name |Description|
41+
|:----------|:----------|
42+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
43+
44+
## Request body
45+
46+
Don't supply a request body for this method.
47+
48+
## Response
49+
50+
If successful, this method returns a `200 OK` response code and a collection of [accessPackageResourceRoleScope](../resources/accesspackageresourcerolescope.md) objects in the response body.
51+
52+
## Examples
53+
54+
### Request
55+
56+
The following example shows a request.
57+
58+
<!-- {
59+
"blockType": "request",
60+
"name": "list_availableaccesspackage_resourcerolescopes"
61+
}-->
62+
63+
```msgraph-interactive
64+
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/availableAccessPackages/360fa7de-90be-48dc-a2ce-fc40094a93dd/resourceRoleScopes
65+
```
66+
67+
68+
### Response
69+
70+
The following example shows the response.
71+
72+
> **Note:** The response object shown here might be shortened for readability.
73+
74+
<!-- {
75+
"blockType": "response",
76+
"truncated": true,
77+
"@odata.type": "Collection(microsoft.graph.accessPackageResourceRoleScope)"
78+
} -->
79+
80+
```http
81+
HTTP/1.1 200 OK
82+
Content-type: application/json
83+
84+
{
85+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/availableAccessPackages('360fa7de-90be-48dc-a2ce-fc40094a93dd')/resourceRoleScopes",
86+
"value": [
87+
{
88+
"id": "c8f7be1e-3e35-4c80-b4f1-7c9ec23bbf77_9b5e1b3d-e4c2-4b8a-8f5b-2a3c9d4e5f6b",
89+
"createdBy": "[email protected]",
90+
"createdDateTime": "2024-01-15T09:30:00Z",
91+
"modifiedBy": "[email protected]",
92+
"modifiedDateTime": "2024-01-15T09:30:00Z"
93+
}
94+
]
95+
}
96+
```

‎api-reference/beta/api/driveitem-delta.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ GET /drives/{drive-id}/root/delta
4343
GET /groups/{groupId}/drive/root/delta
4444
GET /me/drive/root/delta
4545
GET /sites/{siteId}/drive/root/delta
46-
GET /users/{userId}/drive/root/delta
46+
GET /users/{userId | userPrincipalName}/drive/root/delta
4747
```
4848

4949
## Function parameters

‎api-reference/beta/api/driveitem-get.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,8 +44,8 @@ GET /me/drive/items/{item-id}
4444
GET /me/drive/root:/{item-path}
4545
GET /sites/{siteId}/drive/items/{itemId}
4646
GET /sites/{siteId}/drive/root:/{item-path}
47-
GET /users/{userId}/drive/items/{itemId}
48-
GET /users/{userId}/drive/root:/{item-path}
47+
GET /users/{userId | userPrincipalName}/drive/items/{item-id}
48+
GET /users/{userId | userPrincipalName}/drive/root:/{item-path}
4949
```
5050

5151
## Optional query parameters

‎api-reference/beta/api/driveitem-list-children.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ GET /drives/{drive-id}/items/{item-id}/children
3737
GET /groups/{group-id}/drive/items/{item-id}/children
3838
GET /me/drive/items/{item-id}/children
3939
GET /sites/{site-id}/drive/items/{item-id}/children
40-
GET /users/{user-id}/drive/items/{item-id}/children
40+
GET /users/{user-id | userPrincipalName}/drive/items/{item-id}/children
4141
```
4242

4343
## Optional query parameters

‎api-reference/beta/api/driveitem-search.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ GET /drives/{drive-id}/root/search(q='{search-text}')
3434
GET /groups/{group-id}/drive/root/search(q='{search-text}')
3535
GET /me/drive/root/search(q='{search-text}')
3636
GET /sites/{site-id}/drive/root/search(q='{search-text}')
37-
GET /users/{user-id}/drive/root/search(q='{search-text}')
37+
GET /users/{user-id | userPrincipalName}/drive/root/search(q='{search-text}')
3838
```
3939

4040
## Optional query parameters

0 commit comments

Comments
 (0)