Skip to content

Commit fa751ac

Browse files
learn-build-service-prod[bot]learn-build-service-prod[bot]
authored
Merge pull request #28940 from microsoftgraph/main
Auto Publish – main to live - 2026-05-23 00:30 UTC
2 parents 86e9fbe + c5e6954 commit fa751ac

54 files changed

Lines changed: 1431 additions & 69 deletions

File tree

Some content is hidden

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

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

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
---
2+
title: "Get correlatedIdentity"
3+
description: "Get a correlated identity result from an identity correlation report."
4+
author: "tolian"
5+
ms.date: 05/07/2026
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-monitoring-health"
8+
doc_type: apiPageType
9+
---
10+
11+
# Get correlatedIdentity
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get a [correlatedIdentity](../resources/correlatedidentity.md) object from an [identityCorrelation](../resources/identitycorrelation.md) object.
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+
<!-- {
24+
"blockType": "permissions",
25+
"name": "correlatedidentity-get-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/correlatedidentity-get-permissions.md)]
29+
30+
[!INCLUDE [rbac-identity-correlation-apis-read](../includes/rbac-for-apis/rbac-identity-correlation-apis-read.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
GET /reports/correlations/{identityCorrelationId}/identities/{correlatedIdentityId}
40+
```
41+
42+
## Optional query parameters
43+
44+
Not supported.
45+
46+
## Request headers
47+
48+
|Name|Description|
49+
|:---|:---|
50+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
51+
52+
## Request body
53+
54+
Don't supply a request body for this method.
55+
56+
## Response
57+
58+
If successful, this method returns a `200 OK` response code and a [correlatedIdentity](../resources/correlatedidentity.md) object in the response body.
59+
60+
## Examples
61+
62+
### Request
63+
64+
The following example shows a request.
65+
<!-- {
66+
"blockType": "request",
67+
"name": "get_correlatedidentity"
68+
}
69+
-->
70+
``` http
71+
GET https://graph.microsoft.com/beta/reports/correlations/{identityCorrelationId}/identities/{correlatedIdentityId}
72+
```
73+
74+
### Response
75+
76+
The following example shows the response.
77+
>**Note:** The response object shown here might be shortened for readability.
78+
<!-- {
79+
"blockType": "response",
80+
"truncated": true,
81+
"@odata.type": "microsoft.graph.correlatedIdentity"
82+
}
83+
-->
84+
``` http
85+
HTTP/1.1 200 OK
86+
Content-Type: application/json
87+
88+
{
89+
"@odata.type": "#microsoft.graph.correlatedIdentity",
90+
"id": "a3f7b2c1-4e89-4d6a-b5c8-9e2f1a7d3b60",
91+
"correlatedDateTime": "2026-05-01T01:27:00Z",
92+
"sourceIdentity": {
93+
"anchor": {
94+
"name": "objectId",
95+
"value": "jamie998877"
96+
},
97+
"matchingProperty": {
98+
"name": "userPrincipalName",
99+
"value": "jamie@contoso.com"
100+
},
101+
"identityType": "user",
102+
"details": {}
103+
},
104+
"targetIdentity": {
105+
"anchor": {
106+
"name": "id",
107+
"value": "d8e4c6a2-7f13-4b95-a1d9-5c3e8b6f2a74"
108+
},
109+
"matchingProperty": {
110+
"name": "upn",
111+
"value": "jamie@contoso.com"
112+
},
113+
"identityType": "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User",
114+
"details": {}
115+
},
116+
"status": "correlatedAssigned",
117+
"error": null
118+
}
119+
```

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

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
---
2+
title: "Get identityCorrelation"
3+
description: "Get an identity correlation report."
4+
author: "tolian"
5+
ms.date: 05/07/2026
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-monitoring-health"
8+
doc_type: apiPageType
9+
---
10+
11+
# Get identityCorrelation
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get an [identityCorrelation](../resources/identitycorrelation.md) object.
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+
<!-- {
24+
"blockType": "permissions",
25+
"name": "identitycorrelation-get-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/identitycorrelation-get-permissions.md)]
29+
30+
[!INCLUDE [rbac-identity-correlation-apis-read](../includes/rbac-for-apis/rbac-identity-correlation-apis-read.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
GET /reports/correlations/{identityCorrelationId}
40+
```
41+
42+
## Optional query parameters
43+
44+
Not supported.
45+
46+
## Request headers
47+
48+
|Name|Description|
49+
|:---|:---|
50+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
51+
52+
## Request body
53+
54+
Don't supply a request body for this method.
55+
56+
## Response
57+
58+
If successful, this method returns a `200 OK` response code and an [identityCorrelation](../resources/identitycorrelation.md) object in the response body.
59+
60+
## Examples
61+
62+
### Request
63+
64+
The following example shows a request.
65+
<!-- {
66+
"blockType": "request",
67+
"name": "get_identitycorrelation"
68+
}
69+
-->
70+
``` http
71+
GET https://graph.microsoft.com/beta/reports/correlations/{identityCorrelationId}
72+
```
73+
74+
### Response
75+
76+
The following example shows the response.
77+
>**Note:** The response object shown here might be shortened for readability.
78+
<!-- {
79+
"blockType": "response",
80+
"truncated": true,
81+
"@odata.type": "microsoft.graph.identityCorrelation"
82+
}
83+
-->
84+
``` http
85+
HTTP/1.1 200 OK
86+
Content-Type: application/json
87+
88+
{
89+
"@odata.type": "#microsoft.graph.identityCorrelation",
90+
"id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
91+
"startDateTime": "2026-05-01T00:00:00Z",
92+
"endDateTime": "2026-05-01T01:30:00Z",
93+
"error": null,
94+
"servicePrincipal": {
95+
"id": "550e8400-e29b-41d4-a716-446655440000"
96+
}
97+
}
98+
```

0 commit comments

Comments
 (0)