Skip to content

Commit 4212e6d

Browse files
authored
Merge pull request #28204 from microsoftgraph/reezaali-addClientRequestIdHeader
Added client-request-id header information
2 parents d384b1e + 8964984 commit 4212e6d

8 files changed

Lines changed: 29 additions & 13 deletions

api-reference/beta/api/tenantdatasecurityandgovernance-processcontentasync.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
title: "tenantDataSecurityAndGovernance: processContentAsync"
33
toc.title: "tenantDataSecurityAndGovernance: processContentAsync"
44
description: "Process a batch of tenant-wide content entries asynchronously against data protection policies."
5-
author: "ArunGedela"
6-
ms.date: 04/08/2025
5+
author: "reezaali149"
6+
ms.date: 02/06/2026
77
ms.localizationpriority: medium
88
ms.subservice: "security"
99
doc_type: apiPageType
@@ -38,6 +38,7 @@ POST /security/dataSecurityAndGovernance/processContentAsync
3838
| :------------ | :------------ |
3939
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
4040
| Content-Type | application/json. Required. |
41+
| Client-Request-Id | String (GUID recommended). Optional. Unique identifier for this request, which is used for tracing and debugging in logs and support interactions. If an ID is not provided, one may be generated automatically. We recommend that you specify the ID to make tracing and debugging easier. The same ID that was sent in the request will be returned in the response. |
4142

4243
## Request body
4344

api-reference/beta/api/tenantprotectionscopecontainer-compute.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "tenantProtectionScopeContainer: compute"
33
toc.title: "tenantProtectionScopeContainer: compute"
44
description: "Compute the tenant-wide data protection policies and actions, including user or group scoping."
55
author: "kylemar"
6-
ms.date: 06/19/2025
6+
ms.date: 02/06/2026
77
ms.localizationpriority: medium
88
ms.subservice: "security"
99
doc_type: apiPageType
@@ -38,6 +38,7 @@ POST /security/dataSecurityAndGovernance/protectionScopes/compute
3838
| :------------ | :------------ |
3939
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
4040
| Content-Type | application/json. Required. |
41+
| Client-Request-Id | String (GUID recommended). Optional. Unique identifier for this request, which is used for tracing and debugging in logs and support interactions. If an ID is not provided, one may be generated automatically. We recommend that you specify the ID to make tracing and debugging easier. The same ID that was sent in the request will be returned in the response. |
4142

4243
## Request body
4344

api-reference/beta/api/userdatasecurityandgovernance-processcontent.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "userDataSecurityAndGovernance: processContent"
33
toc.title: "userDataSecurityAndGovernance: processContent"
44
description: "Process content against data protection policies in the context of the current, or specified, user."
55
author: "kylemar"
6-
ms.date: 06/19/2025
6+
ms.date: 02/06/2026
77
ms.localizationpriority: medium
88
ms.subservice: "security"
99
doc_type: apiPageType
@@ -47,6 +47,7 @@ POST /users/{userId}/dataSecurityAndGovernance/processContent
4747
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
4848
|Content-Type|application/json. Required.|
4949
| If-None-Match | Optional. This value is used by the API to determine if the policy state changed since the last call to the API. The value is from the Etag header returned from [protectionScopes compute](../api/userprotectionscopecontainer-compute.md). If newly computed Etag value does not match the value passsed in this header, protectionScopeState property returned will be "modified" and the app needs to refresh by calling [protectionScopes compute](../api/userprotectionscopecontainer-compute.md). |
50+
| Client-Request-Id | String (GUID recommended). Optional. Unique identifier for this request, which is used for tracing and debugging in logs and support interactions. If an ID is not provided, one may be generated automatically. We recommend that you specify the ID to make tracing and debugging easier. The same ID that was sent in the request will be returned in the response. |
5051

5152
## Request body
5253

@@ -84,6 +85,7 @@ The following example shows a request.
8485
```http
8586
POST https://graph.microsoft.com/beta/me/dataSecurityAndGovernance/processContent
8687
Content-Type: application/json
88+
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736
8789
8890
{
8991
"contentToProcess": {
@@ -170,6 +172,7 @@ The following example shows the response.
170172
```http
171173
HTTP/1.1 200 OK
172174
Content-Type: application/json
175+
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736
173176
174177
{
175178
"@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.processContentResponse",

api-reference/beta/api/userprotectionscopecontainer-compute.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "userProtectionScopeContainer: compute"
33
toc.title: "userProtectionScopeContainer: compute"
44
description: "Compute the data protection policies and actions applicable to a specific user based on their context."
55
author: "kylemar"
6-
ms.date: 06/19/2025
6+
ms.date: 02/06/2026
77
ms.localizationpriority: medium
88
ms.subservice: "security"
99
doc_type: apiPageType
@@ -46,7 +46,8 @@ POST /users/{usersId}/dataSecurityAndGovernance/protectionScopes/compute
4646
| :------------ | :------------ |
4747
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
4848
| Content-Type | application/json. Required. |
49-
| If-None-Match | Optional. This value is used by the API to determine if the policy state has changed since the last call to the API. |
49+
| If-None-Match | Optional. This value is used by the API to determine if the policy state changed since the last call to the API. |
50+
| Client-Request-Id | String (GUID recommended). Optional. Unique identifier for this request, which is used for tracing and debugging in logs and support interactions. If an ID isn't provided, one may be generated automatically. We recommend that you specify the ID to make tracing and debugging easier. The same ID that was sent in the request is returned in the response. |
5051

5152
## Request body
5253

@@ -64,7 +65,7 @@ In the request body, provide a JSON object with the following parameters.
6465

6566
| Name | Description |
6667
| :------------ | :------------ |
67-
| ETag | An indicator whether the admin-configured policy state has changed. If the Etag matches the If-None-Match value and you have cached the results of parsing previous results from this API, there is no need to parse the response and cache the parsed results. Cache this value for calls to [process content](../api/userdatasecurityandgovernance-processcontent.md). |
68+
| ETag | An indicator whether the admin-configured policy state changed. If the Etag matches the If-None-Match value and you cached the results of parsing previous results from this API, there's no need to parse the response and cache the parsed results. Cache this value for calls to [process content](../api/userdatasecurityandgovernance-processcontent.md). |
6869

6970
## Response
7071

@@ -79,6 +80,7 @@ The following example computes the protection scope for a user performing text u
7980
```http
8081
POST https://graph.microsoft.com/beta/users/7c1f8f10-cba8-4a8d-9449-db4b876d1ef70/dataSecurityAndGovernance/protectionScopes/compute
8182
Content-type: application/json
83+
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736
8284
8385
{
8486
"activities": "uploadText,downloadText",
@@ -100,6 +102,7 @@ The following example shows the response. It indicates that for the `uploadText`
100102
```http
101103
HTTP/1.1 200 OK
102104
Content-type: application/json
105+
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736
103106
104107
{
105108
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.policyUserScope)",

api-reference/v1.0/api/tenantdatasecurityandgovernance-processcontentasync.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "tenantDataSecurityAndGovernance: processContentAsync"
33
toc.title: "tenantDataSecurityAndGovernance: processContentAsync"
44
description: "Process a batch of tenant-wide content entries asynchronously against data protection policies."
55
author: "kylemar"
6-
ms.date: 06/19/2025
6+
ms.date: 02/06/2026
77
ms.localizationpriority: medium
88
ms.subservice: "security"
99
doc_type: apiPageType
@@ -36,6 +36,7 @@ POST /security/dataSecurityAndGovernance/processContentAsync
3636
| :------------ | :------------ |
3737
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
3838
| Content-Type | application/json. Required. |
39+
| Client-Request-Id | String (GUID recommended). Optional. Unique identifier for this request, which is used for tracing and debugging in logs and support interactions. If an ID is not provided, one may be generated automatically. We recommend that you specify the ID to make tracing and debugging easier. The same ID that was sent in the request will be returned in the response. |
3940

4041
## Request body
4142

api-reference/v1.0/api/tenantprotectionscopecontainer-compute.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "tenantProtectionScopeContainer: compute"
33
toc.title: "tenantProtectionScopeContainer: compute"
44
description: "Compute the tenant-wide data protection policies and actions, including user or group scoping."
55
author: "kylemar"
6-
ms.date: 06/19/2025
6+
ms.date: 02/06/2026
77
ms.localizationpriority: medium
88
ms.subservice: "security"
99
doc_type: apiPageType
@@ -36,6 +36,7 @@ POST /security/dataSecurityAndGovernance/protectionScopes/compute
3636
| :------------ | :------------ |
3737
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
3838
| Content-Type | application/json. Required. |
39+
| Client-Request-Id | String (GUID recommended). Optional. Unique identifier for this request, which is used for tracing and debugging in logs and support interactions. If an ID is not provided, one may be generated automatically. We recommend that you specify the ID to make tracing and debugging easier. The same ID that was sent in the request will be returned in the response. |
3940

4041
## Request body
4142

api-reference/v1.0/api/userdatasecurityandgovernance-processcontent.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "userDataSecurityAndGovernance: processContent"
33
toc.title: "userDataSecurityAndGovernance: processContent"
44
description: "Process content against data protection policies in the context of the current, or specified, user."
55
author: "kylemar"
6-
ms.date: 06/19/2025
6+
ms.date: 02/06/2026
77
ms.localizationpriority: medium
88
ms.subservice: "security"
99
doc_type: apiPageType
@@ -45,6 +45,7 @@ POST /users/{userId}/dataSecurityAndGovernance/processContent
4545
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
4646
|Content-Type|application/json. Required.|
4747
| If-None-Match | Optional. This value is used by the API to determine if the policy state changed since the last call to the API. The value is from the Etag header returned from [protectionScopes compute](../api/userprotectionscopecontainer-compute.md). If newly computed Etag value does not match the value passsed in this header, protectionScopeState property returned will be "modified" and the app needs to refresh by calling [protectionScopes compute](../api/userprotectionscopecontainer-compute.md). |
48+
| Client-Request-Id | String (GUID recommended). Optional. Unique identifier for this request, which is used for tracing and debugging in logs and support interactions. If an ID is not provided, one may be generated automatically. We recommend that you specify the ID to make tracing and debugging easier. The same ID that was sent in the request will be returned in the response. |
4849

4950
## Request body
5051

@@ -82,6 +83,7 @@ The following example shows a request.
8283
```http
8384
POST https://graph.microsoft.com/v1.0/me/dataSecurityAndGovernance/processContent
8485
Content-Type: application/json
86+
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736
8587
8688
{
8789
"contentToProcess": {
@@ -167,6 +169,7 @@ The following example shows the response.
167169
```http
168170
HTTP/1.1 200 OK
169171
Content-Type: application/json
172+
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736
170173
171174
{
172175
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.processContentResponse",

api-reference/v1.0/api/userprotectionscopecontainer-compute.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "userProtectionScopeContainer: compute"
33
toc.title: "userProtectionScopeContainer: compute"
44
description: "Compute the data protection policies and actions applicable to a specific user based on their context."
55
author: "kylemar"
6-
ms.date: 06/19/2025
6+
ms.date: 02/06/2026
77
ms.localizationpriority: medium
88
ms.subservice: "security"
99
doc_type: apiPageType
@@ -44,6 +44,7 @@ POST /users/{usersId}/dataSecurityAndGovernance/protectionScopes/compute
4444
| :------------ | :------------ |
4545
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
4646
| Content-Type | application/json. Required. |
47+
| Client-Request-Id | String (GUID recommended). Optional. Unique identifier for this request, which is used for tracing and debugging in logs and support interactions. If an ID isn't provided, one may be generated automatically. We recommend that you specify the ID to make tracing and debugging easier. The same ID that was sent in the request is returned in the response. |
4748

4849
## Request body
4950

@@ -61,7 +62,7 @@ In the request body, provide a JSON object with the following parameters.
6162

6263
| Name | Description |
6364
| :------------ | :------------ |
64-
| ETag | An indicator whether the admin-configured policy state has changed. If you have cached Etag value and it matches ETag from previous results from this API, there is no need to parse the response and cache the parsed results. Cache this value for calls to [process content](../api/userdatasecurityandgovernance-processcontent.md). |
65+
| ETag | An indicator whether the admin-configured policy state changed. If you cached Etag value and it matches ETag from previous results from this API, there's no need to parse the response and cache the parsed results. Cache this value for calls to [process content](../api/userdatasecurityandgovernance-processcontent.md). |
6566

6667
## Response
6768

@@ -78,6 +79,7 @@ The following example computes the protection scope for a user performing text u
7879
```http
7980
POST https://graph.microsoft.com/v1.0/users/7c1f8f10-cba8-4a8d-9449-db4b876d1ef70/dataSecurityAndGovernance/protectionScopes/compute
8081
Content-type: application/json
82+
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736
8183
8284
{
8385
"activities": "uploadText,downloadText",
@@ -92,13 +94,14 @@ Content-type: application/json
9294

9395
#### Response
9496

95-
The following example shows the response. It indicates that for the `uploadText` activity for the integrated application with id 83ef208a-0396-4893-9d4f-d36efbffc8bd, policies require inline evaluation. For the `uploadFile` activity for the integrated application with id 83ef208a-0396-4893-9d4f-d36efbffc8bd, policies require offline evaluation and trigger a `restrictAccess` action (likely blocking uploads based on contextual information, e.g. blocking uploads for specific users or group).
97+
The following example shows the response. It indicates that for the `uploadText` activity for the integrated application with id 83ef208a-0396-4893-9d4f-d36efbffc8bd, policies require inline evaluation. For the `uploadFile` activity for the integrated application with id 83ef208a-0396-4893-9d4f-d36efbffc8bd, policies require offline evaluation and trigger a `restrictAccess` action (likely blocking uploads based on contextual information; for example, blocking uploads for specific users or group).
9698

9799
> **Note:** The response object shown here might be shortened for readability.
98100
99101
```http
100102
HTTP/1.1 200 OK
101103
Content-type: application/json
104+
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736
102105
103106
{
104107
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.policyUserScope)",

0 commit comments

Comments
 (0)