Updates from: 05/19/2022 01:06:31
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Educationassignment Post Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-post-resources.md
Create an [assignment resource](../resources/educationassignmentresource.md). Yo
- [educationLinkResource](../resources/educationlinkresource.md) - [educationPowerPointResource](../resources/educationpowerpointresource.md) - [educationMediaResource](../resources/educationmediaresource.md)
+- [educationTeamsAppResource](../resources/educationteamsappresource.md)
Every resource has an @odata.type property to indicate which type of resource is being created.
In the request body, supply a JSON representation of one of the following resour
- [educationLinkResource](../resources/educationlinkresource.md) - [educationPowerPointResource](../resources/educationpowerpointresource.md) - [educationMediaResource](../resources/educationmediaresource.md)
+- [educationTeamsAppResource](../resources/educationteamsappresource.md)
>**Note:** You can't use this operation to create an [educationExternalResource](../resources/educationexternalresource.md).
Content-type: application/json
} ```
+### Example 7: Create an educationTeamsAppResource
+#### Request
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "sampleKeys": ["72a7baec-c3e9-4213-a850-f62de0adad5f","1618dfb0-3ff2-4edf-8d5c-b8f81df00e80"],
+ "name": "create_educationTeamsAppResource_from_educationassignment"
+}-->
+```http
+POST https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignments/1618dfb0-3ff2-4edf-8d5c-b8f81df00e80/resources
+Content-type: application/json
+
+{
+ "distributeForStudentWork": false,
+ "resource": {
+ "displayName": "Template - My Story",
+ "appId": "6fbeb90c-3d55-4bd5-82c4-bfe824be4300",
+ "appIconWebUrl": "https://statics.teams.cdn.office.net/evergreen-assets/ThirdPartyApps/6fbeb90c-3d55-4bd5-82c4-bfe824be4300_largeImage.png?v=2.0.2",
+ "teamsEmbeddedContentUrl": "https://app.api.edu.buncee.com/player/C7B0866C9B7E485EAE21AE14DBC3FD08?embed=1&render_slide_panel=1",
+ "webUrl": "https://app.edu.buncee.com/buncee/C7B0866C9B7E485EAE21AE14DBC3FD08",
+ "@odata.type": "#microsoft.graph.educationTeamsAppResource"
+ }
+}
+```
+
+#### Response
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.educationMediaResource"
+} -->
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignments('1618dfb0-3ff2-4edf-8d5c-b8f81df00e80')/resources/$entity",
+ "distributeForStudentWork": false,
+ "id": "5bae19da-a720-4046-8af8-f56b9ae62d25",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationTeamsAppResource",
+ "displayName": "Template - My Story",
+ "createdDateTime": "2022-04-22T13:51:20.577384Z",
+ "lastModifiedDateTime": "2022-04-22T13:51:20.577384Z",
+ "appId": "6fbeb90c-3d55-4bd5-82c4-bfe824be4300",
+ "appIconWebUrl": "https://statics.teams.cdn.office.net/evergreen-assets/ThirdPartyApps/6fbeb90c-3d55-4bd5-82c4-bfe824be4300_largeImage.png?v=2.0.2",
+ "teamsEmbeddedContentUrl": "https://app.api.edu.buncee.com/player/C7B0866C9B7E485EAE21AE14DBC3FD08?embed=1&render_slide_panel=1",
+ "webUrl": "https://app.edu.buncee.com/buncee/C7B0866C9B7E485EAE21AE14DBC3FD08",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a",
+ "displayName": null
+ }
+ }
+ }
+}
+```
++ ## See also
v1.0 Educationassignment Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationassignment-setupresourcesfolder.md
POST /education/classes/{id}/assignments/{id}/setUpResourcesFolder
## Request headers | Header | Value | |:|:--|
-| Authorization | Bearer `{token}`. Required. |
+| Authorization | Bearer {token}. Required. |
+| Content-Type | application/json. Required. |
## Request body
-You need to provide an empty json `{}` as request body for this method.
+In the request body, supply an empty JSON object `{}` for this method.
+ ## Response
-If successful, this method returns a 200 Ok response code and [educationAssignment](/graph/api/resources/educationAssignment?view=graph-rest-beta&preserve-view=true) object in the request body.
+If successful, this method returns a `200 OK` response code and an [educationAssignment](/graph/api/resources/educationassignment?view=graph-rest-beta&preserve-view=true) object in the request body.
If the specified **assignment** already has a folder, this method returns a `400 Bad request` and an error response.
Content-type: application/json
### Response
-The following is an example of a response.
+The following is an example of the response.
<!-- { "blockType": "response",
v1.0 Subjectrightsrequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subjectrightsrequest-get.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request + <!-- { "blockType": "ignored" } --> ``` http
+GET /security/subjectRightsRequests/{subjectRightsRequestId}
GET /privacy/subjectRightsRequests/{subjectRightsRequestId} ```
GET https://graph.microsoft.com/beta/privacy/subjectRightsRequests/{subjectRight
HTTP/1.1 200 OK Content-Type: application/json
- {
- "type": "microsoft.graph.subjectRightsRequestType",
- "dataSubjectType": "microsoft.graph.dataSubjectType",
+{
+ "type": "export",
+ "dataSubjectType": "customer",
"regulations": [
- "String"
+ "GDPR"
],
- "displayName": "String",
- "description": "String",
+ "displayName": "Export request for Monica Thompson",
+ "description": "This is a export request",
"status": "active",
- "internalDueDateTime": "String",
- "lastModifiedDateTime": "String",
- "id": "String",
- "createdDateTime": "String",
+ "internalDueDateTime": "2022-06-20T22:42:28Z",
+ "lastModifiedDateTime": "2022-04-20T22:42:28Z",
+ "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
+ "createdDateTime": "2022-04-19T22:42:28Z",
"stages": [ { "stage": "contentRetrieval",
Content-Type: application/json
} ], "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
+ "user": {
+ "id": "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
+ "displayName": "srradmin@contoso.com"
+ }
}, "lastModifiedBy": {
- "@odata.type": "microsoft.graph.identitySet"
+ "user": {
+ "id": "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
+ "displayName": "srradmin@contoso.com"
+ }
}, "dataSubject": {
- "firstName": "String",
- "lastName": "String",
- "email": "String",
- "residency": "String",
- "phoneNumber": "String",
- "SSN": "String"
+ "firstName": "Monica",
+ "lastName": "Thompson",
+ "email": "Monica.Thompson@contoso.com",
+ "residency": "USA",
+ "SSN": "123-456-7890"
}, "team": {
- "id": "String (identifier)",
- "webUrl": "String"
+ "id": "5484809c-fb5b-415a-afc6-da7ff601034e",
+ "webUrl": "https://teams.contoso.com/teams/teamid"
+ },
+ "includeAllVersions": false,
+ "pauseAfterEstimate": true,
+ "includeAuthoredContent": true,
+ "externalId": null,
+ "contentQuery": "(('Monica Thompson' OR 'Monica.Thompson@contoso.com') OR (participants=Monica.Thompson@contoso.com))",
+ "mailboxLocations": null,
+ "siteLocations": {
+ "@odata.type": "microsoft.graph.subjectRightsRequestAllSiteLocation"
} } ```
v1.0 Subjectrightsrequest Getfinalattachment https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subjectrightsrequest-getfinalattachment.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request + <!-- { "blockType": "ignored" } --> ``` http
+GET /security/subjectRightsRequests/{subjectRightsRequestId}/getFinalAttachment
GET /privacy/subjectRightsRequests/{subjectRightsRequestId}/getFinalAttachment ```
v1.0 Subjectrightsrequest Getfinalreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subjectrightsrequest-getfinalreport.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request + <!-- { "blockType": "ignored" } --> ``` http
+GET /security/subjectRightsRequests{subjectRightsRequestId}/getFinalReport
GET /privacy/subjectRightsRequests{subjectRightsRequestId}/getFinalReport ```
v1.0 Subjectrightsrequest List Notes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subjectrightsrequest-list-notes.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request + <!-- { "blockType": "ignored" } --> ``` http
+GET /security/subjectRightsRequests/{subjectRightsRequestId}/notes
GET /privacy/subjectRightsRequests/{subjectRightsRequestId}/notes ```
Content-Type: application/json
"@odata.context": "https://graph.microsoft.com/beta/privacy/subjectRightsRequests('77f885ac-1d7b-4317-bde8-4cb3d24a3ed8')/notes", "value": [ {
- "id": "String (identifier)",
- "createdDateTime": "String (timestamp)",
- "author": { "@odata.type": "microsoft.graph.identitySet"},
+ "id": "73A1E594-D973-4740-B1CC-42FD21727543",
+ "createdDateTime": "2022-06-20T22:42:28Z",
+ "author": {
+ "user": {
+ "id": "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
+ "displayName": "srradmin@contoso.com"
+ }
+ },
"content": {
- "@odata.type": "microsoft.graph.itemBody"
+ "content": "Please review all the files tagged with follow up.",
+ "contentType": "text"
} } ]
v1.0 Subjectrightsrequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subjectrightsrequest-list.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request + <!-- { "blockType": "ignored" } --> ``` http
+GET /security/subjectRightsRequests
GET /privacy/subjectRightsRequests ```
HTTP/1.1 200 OK
Content-Type: application/json {
- "value": [
- {
- "type": "microsoft.graph.subjectRightsRequestType",
- "dataSubjectType": "microsoft.graph.dataSubjectType",
- "regulations": [
- "String"
- ],
- "displayName": "String",
- "description": "String",
- "status": "active",
- "internalDueDateTime": "String",
- "lastModifiedDateTime": "String",
- "id": "String",
- "createdDateTime": "String",
- "stages": [
- {
- "stage": "contentRetrieval",
- "status": "notStarted",
- "error": null
- },
- {
- "stage": "contentReview",
- "status": "notStarted",
- "error": null
- },
+ "value": [
{
- "stage": "generateReport",
- "status": "notStarted",
- "error": null
+ "type": "export",
+ "dataSubjectType": "customer",
+ "regulations": [
+ "GDPR"
+ ],
+ "displayName": "Export request for Monica Thompson",
+ "description": "This is a export request",
+ "status": "active",
+ "internalDueDateTime": "2022-06-20T22:42:28Z",
+ "lastModifiedDateTime": "2022-04-20T22:42:28Z",
+ "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
+ "createdDateTime": "2022-04-19T22:42:28Z",
+ "stages": [
+ {
+ "stage": "contentRetrieval",
+ "status": "notStarted",
+ "error": null
+ },
+ {
+ "stage": "contentReview",
+ "status": "notStarted",
+ "error": null
+ },
+ {
+ "stage": "generateReport",
+ "status": "notStarted",
+ "error": null
+ },
+ {
+ "stage": "caseResolved",
+ "status": "notStarted",
+ "error": null
+ }
+ ],
+ "createdBy": {
+ "user": {
+ "id": "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
+ "displayName": "srradmin@contoso.com"
+ }
+ },
+ "lastModifiedBy": {
+ "user": {
+ "id": "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
+ "displayName": "srradmin@contoso.com"
+ }
+ },
+ "dataSubject": {
+ "firstName": "Monica",
+ "lastName": "Thompson",
+ "email": "Monica.Thompson@contoso.com",
+ "residency": "USA"
+ },
+ "team": {
+ "id": "5484809c-fb5b-415a-afc6-da7ff601034e",
+ "webUrl": "https://teams.contoso.com/teams/teamid"
+ },
+ "includeAllVersions": false,
+ "pauseAfterEstimate": true,
+ "includeAuthoredContent": true,
+ "externalId": null,
+ "contentQuery": "(('Monica Thompson' OR 'Monica.Thompson@contoso.com') OR (participants=Monica.Thompson@contoso.com))",
+ "mailboxLocations": null,
+ "siteLocations": {
+ "@odata.type": "microsoft.graph.subjectRightsRequestAllSiteLocation"
+ }
}, {
- "stage": "caseResolved",
- "status": "notStarted",
- "error": null
+ "type": "export",
+ "dataSubjectType": "customer",
+ "regulations": [
+ "GDPR"
+ ],
+ "displayName": "Export request for Alex.Wilber",
+ "description": "This is a export request",
+ "status": "active",
+ "internalDueDateTime": "2022-06-20T22:42:28Z",
+ "lastModifiedDateTime": "2022-04-20T22:42:28Z",
+ "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
+ "createdDateTime": "2022-04-19T22:42:28Z",
+ "stages": [
+ {
+ "stage": "contentRetrieval",
+ "status": "notStarted",
+ "error": null
+ },
+ {
+ "stage": "contentReview",
+ "status": "notStarted",
+ "error": null
+ },
+ {
+ "stage": "generateReport",
+ "status": "notStarted",
+ "error": null
+ },
+ {
+ "stage": "caseResolved",
+ "status": "notStarted",
+ "error": null
+ }
+ ],
+ "createdBy": {
+ "user": {
+ "id": "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
+ "displayName": "srradmin@contoso.com"
+ }
+ },
+ "lastModifiedBy": {
+ "user": {
+ "id": "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
+ "displayName": "srradmin@contoso.com"
+ }
+ },
+ "dataSubject": {
+ "firstName": "Alex",
+ "lastName": "Wilber",
+ "email": "Alex.Wilber@contoso.com"
+ },
+ "team": {
+ "id": "5484809c-fb5b-415a-afc6-da7ff601034e",
+ "webUrl": "https://teams.contoso.com/teams/teamid"
+ },
+ "includeAllVersions": false,
+ "pauseAfterEstimate": true,
+ "includeAuthoredContent": true,
+ "externalId": null,
+ "contentQuery": "(('Alex Wilber' OR 'Alex.Wilber@contoso.com') OR (participants=Alex.Wilber@contoso.com))",
+ "mailboxLocations": {
+ "@odata.type": "microsoft.graph.subjectRightsRequestAllMailBoxLocation"
+ },
+ "siteLocations": {
+ "@odata.type": "microsoft.graph.subjectRightsRequestAllSiteLocation"
+ }
}
- ],
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "lastModifiedBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "dataSubject": {
- "firstName": "String",
- "lastName": "String",
- "email": "String",
- "residency": "String",
- "phoneNumber": "String",
- "SSN": "String"
- },
- "team": {
- "id": "String (identifier)",
- "webUrl": "String"
- }
- }
- ]
+ ]
} ```
v1.0 Subjectrightsrequest Post Notes https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subjectrightsrequest-post-notes.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request + <!-- { "blockType": "ignored" } --> ``` http
+POST /security/subjectRightsRequests/{subjectRightsRequestId}/notes
POST /privacy/subjectRightsRequests/{subjectRightsRequestId}/notes ```
POST https://graph.microsoft.com/beta/privacy/subjectRightsRequests/{subjectRigh
Content-Type: application/json {
-"content":
- {
- "content": "String",
- "contentType": "text"
- }
+ "content": {
+ "content": "Please take a look at the files tagged with follow up",
+ "contentType": "text"
+ }
} ``` # [C#](#tab/csharp)
HTTP/1.1 201 Created
Content-Type: application/json {
- "id": "String (identifier)",
- "createdDateTime": "String (timestamp)",
- "author": { "@odata.type": "microsoft.graph.identitySet"},
+ "id": "D450C4F9-CC18-4784-9406-9372F4E05F7B",
+ "createdDateTime": "2022-05-10T22:42:28Z",
+ "author": {
+ "user": {
+ "id": "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
+ "displayName": "srradmin@contoso.com"
+ }
+ },
"content": {
- "@odata.type": "microsoft.graph.itemBody"
+ "content": "Please take a look at the files tagged with follow up",
+ "contentType": "text"
}- } ```
v1.0 Subjectrightsrequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subjectrightsrequest-post.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Create a new [subjectRightsRequest](../resources/subjectRightsRequest.md) object.
+Create a new [subjectRightsRequest](../resources/subjectrightsrequest.md) object.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
One of the following permissions is required to call this API. To learn more, in
## HTTP request + <!-- { "blockType": "ignored" } --> ``` http
+POST /security/subjectRightsRequests
POST /privacy/subjectRightsRequests+ ``` ## Request headers
POST /privacy/subjectRightsRequests
|Content-Type|application/json. Required.| ## Request body
-In the request body, supply a JSON representation of the [subjectRightsRequest](../resources/subjectRightsRequest.md) object.
+In the request body, supply a JSON representation of the [subjectRightsRequest](../resources/subjectrightsrequest.md) object.
-The following table shows the properties that are required when you create the [subjectRightsRequest](../resources/subjectRightsRequest.md).
+The following table shows the properties that are required when you create the [subjectRightsRequest](../resources/subjectrightsrequest.md).
|Property|Type|Description| |:|:|:|
+| contentQuery | String | KQL based content query that should be used for search. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
|dataSubject|[microsoft.graph.dataSubject](../resources/datasubject.md)|Contains the properties for data subject for the request.| |dataSubjectType|dataSubjectType|Data subject type. Possible values are: `customer`, `currentEmployee`, `formerEmployee`, `prospectiveEmployee`, `student`, `teacher`, `faculty`, `other`, `unknownFutureValue`.| |description|String|Description for the request.| |displayName|String|Name of the request.|
+| externalId | String| The external ID for the request that is immutable after creation and is used for tracking the request for the external system. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
+| includeAllVersions | Boolean | Include all versions of the documents. By default, the current copies of the documents will be returned. If SharePoint sites have versioning enabled, including all versions will include the historical copies of the documents. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
+| includeAuthoredContent| Boolean | Include content authored by the data subject. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
|internalDueDateTime|DateTimeOffset|Internal due date that is used for tracking the request completion.|
+| mailboxLocations | [subjectRightsRequestMailboxLocation](../resources/subjectrightsrequestmailboxlocation.md)|The mailbox locations that should be searched. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
+| pauseAfterEstimate | Boolean| Pause the request after estimate has finished. By default, the data estimate will run and then pause, allowing you to preview results and then select the option to retrieve data in the UI. You can set this property to `false` if you want it to perform the estimate and then automatically begin with the retrieval of the content. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
|regulations|String collection|One or more regulations for the request.|
-|type|subjectRightsRequestType|Type of the request. Possible values are: `export`, `delete`, `access`, `tagForAction`, `unknownFutureValue`.|
-
+| siteLocations| [subjectRightsRequestSiteLocation](../resources/subjectrightsrequestsitelocation.md)| The SharePoint and OneDrive site locations that should be searched. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
+|type|subjectRightsRequestType|Type of the request. Possible values are: `export`, `access`, `tagForAction`, `unknownFutureValue`. The `delete` type is currently not supported.|
## Response
POST https://graph.microsoft.com/beta/privacy/subjectRightsRequests
Content-Type: application/json {
- "type": "microsoft.graph.subjectRightsRequestType",
- "dataSubjectType": "microsoft.graph.dataSubjectType",
- "regulations": ["String"],
- "displayName": "String",
- "description": "String",
- "internalDueDateTime": "String (timestamp)",
+ "type": "export",
+ "contentQuery": "((\"Diego Siciliani\" OR \"Diego.Siciliani@contoso.com\") OR (participants:\"Diego.Siciliani@contoso.com\"))",
+ "dataSubjectType": "customer",
+ "externalId": "F53BF2DA-607D-412A-B568-FAA0F023AC0B",
+ "displayName": "Export report for customer Id: 12345",
+ "description": "This is a export request",
+ "includeAllVersions": false,
+ "includeAuthoredContent": true,
+ "internalDueDateTime": "2022-07-20T22:42:28Z",
"dataSubject": {
- "firstName": "String",
- "lastName": "String",
- "email": "String",
- "residency": "String",
- "phoneNumber": "String",
- "SSN": "String"
+ "firstName": "Diego",
+ "lastName": "Siciliani",
+ "email": "Diego.Siciliani@contoso.com",
+ "residency": "USA"
+ },
+ "mailboxLocations": null,
+ "pauseAfterEstimate": true,
+ "regulations": [
+ "CCPA"
+ ],
+ "siteLocations": {
+ "@odata.type": "microsoft.graph.subjectRightsRequestAllSiteLocation"
} } ```
HTTP/1.1 201 Created
Content-Type: application/json {
- "type": "microsoft.graph.subjectRightsRequestType",
- "dataSubjectType": "microsoft.graph.dataSubjectType",
+ "type": "export",
+ "dataSubjectType": "customer",
"regulations": [
- "String"
+ "CCPA"
],
- "displayName": "String",
- "description": "String",
+ "displayName": "Export report for customer Id: 12345",
+ "description": "This is a export request",
"status": "active",
- "internalDueDateTime": "String",
- "lastModifiedDateTime": "String",
- "id": "String",
- "createdDateTime": "String",
+ "internalDueDateTime": "2022-07-20T22:42:28Z",
+ "lastModifiedDateTime": "2022-05-10T22:42:28Z",
+ "id": "CA084038-C5D2-493D-8DAB-23FC12393C76",
+ "createdDateTime": "2022-05-10T22:42:28Z",
"stages": [ { "stage": "contentRetrieval", "status": "notStarted",
- "error":
- {
- "@odata.type": "microsoft.graph.publicError"
- }
+ "error": null
}, { "stage": "contentReview", "status": "notStarted",
- "error":
- {
- "@odata.type": "microsoft.graph.publicError"
- }
+ "error": null
}, { "stage": "generateReport", "status": "notStarted",
- "error":
- {
- "@odata.type": "microsoft.graph.publicError"
- }
+ "error": null
}, { "stage": "caseResolved", "status": "notStarted",
- "error":
- {
- "@odata.type": "microsoft.graph.publicError"
- }
+ "error": null
} ], "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
+ "user": {
+ "id": "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
+ "displayName": "srradmin@contoso.com"
+ }
}, "lastModifiedBy": {
- "@odata.type": "microsoft.graph.identitySet"
+ "user": {
+ "id": "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
+ "displayName": "srradmin@contoso.com"
+ }
}, "dataSubject": {
- "firstName": "String",
- "lastName": "String",
- "email": "String",
- "residency": "String",
- "phoneNumber": "String",
- "SSN": "String"
+ "firstName": "Diego",
+ "lastName": "Siciliani",
+ "email": "Diego.Siciliani@contoso.com",
+ "residency": "USA"
}, "team": {
- "id": "String (identifier)",
- "webUrl": "String"
+ "id": "5484809c-fb5b-415a-afc6-da7ff601034e",
+ "webUrl": "https://teams.contoso.com/teams/teamid"
+ },
+ "includeAllVersions": false,
+ "pauseAfterEstimate": false,
+ "includeAuthoredContent": false,
+ "externalId": "F53BF2DA-607D-412A-B568-FAA0F023AC0B",
+ "contentQuery": "((\"Diego Siciliani\" OR \"Diego.Siciliani@contoso.com\") OR (participants:\"Diego.Siciliani@contoso.com\"))",
+ "mailboxLocations": null,
+ "siteLocations": {
+ "@odata.type": "microsoft.graph.subjectRightsRequestAllSiteLocation"
} } ```
v1.0 Subjectrightsrequest Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subjectrightsrequest-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request + <!-- { "blockType": "ignored" } --> ``` http
+PATCH /security/subjectRightsRequests/{subjectRightsRequestId}
PATCH /privacy/subjectRightsRequests/{subjectRightsRequestId} ```
The following table shows the properties that are required when you update the [
|Property|Type|Description| |:|:|:|
-|assignedTo|[microsoft.graph.identity](../resources/identity.md)|The identity information for the user that the request is assigned to.|
|description|String|Updated description for the request.| |displayName|String|Updated name of the request.| |internalDueDateTime|DateTimeOffset|Updated internal due date for the request.|
PATCH https://graph.microsoft.com/beta/privacy/subjectRightsRequests/{subjectRig
Content-Type: application/json {
- "@odata.type": "#microsoft.graph.subjectRightsRequest",
- "internalDueDateTime": "2021-08-30T00:00:00Z"
+ "@odata.type": "#microsoft.graph.subjectRightsRequest",
+ "internalDueDateTime": "2021-08-30T00:00:00Z"
} ``` # [C#](#tab/csharp)
HTTP/1.1 200 OK
Content-Type: application/json {
- "type": "microsoft.graph.subjectRightsRequestType",
- "dataSubjectType": "microsoft.graph.dataSubjectType",
- "regulations": [
- "String"
- ],
- "displayName": "String",
- "description": "String",
- "status": "active",
- "internalDueDateTime": "String",
- "lastModifiedDateTime": "String",
- "id": "String",
- "createdDateTime": "String",
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "lastModifiedBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "dataSubject": {
- "firstName": "String",
- "lastName": "String",
- "email": "String",
- "residency": "String",
- "phoneNumber": "String",
- "SSN": "String"
- },
- "team": {
- "id": "String (identifier)",
- "webUrl": "String"
- }
+ "displayName": "Updated case name for Diego Siciliani",
+ "description": "This is an updated case",
+ "internalDueDateTime": "2022-07-20T22:42:28Z"
} ```
v1.0 Complianceapioverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/complianceapioverview.md
Explore the [Microsoft 365 eDiscovery APIs](ediscovery-ediscoveryapioverview.md)
## Subject rights request
-Privacy management provides powerful subject rights requests capabilities to help you handle requests from people seeking to manage their personal data within your organization. These requests are sometimes also referred to as data subject requests (DSRs), data subject access requests (DSARs), or consumer rights requests. Privacy management empowers personnel responsible for fulfilling subject rights requests to easily identify data subjects and find their personal information among your organizationΓÇÖs data in Exchange, SharePoint, OneDrive, and Teams. Learn more about [Microsoft 365 subject rights requests](/microsoft-365/compliance/privacy-management-subject-rights-requests).
+Microsoft Priva Subject Rights Requests provides powerful capabilities to help you handle requests from people seeking to manage their personal data within your organization. These requests are sometimes also referred to as data subject requests (DSRs), data subject access requests (DSARs), or consumer rights requests. Microsoft Priva empowers personnel responsible for fulfilling subject rights requests to easily identify data subjects and find their personal information among your organizationΓÇÖs data in Exchange, SharePoint, OneDrive, and Teams. Learn more about [Priva Subject Rights Requests](/microsoft-365/compliance/privacy-management-subject-rights-requests).
-Explore the [Microsoft 365 subject rights request APIs](subjectrightsrequest-subjectrightsrequestapioverview.md).
+Explore the [subject rights request APIs](subjectrightsrequest-subjectrightsrequestapioverview.md).
<!-- ## Labels
v1.0 Educationresource https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/educationresource.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-A base class for [educationExcelResource](../resources/educationexcelresource.md), [educationFileResource](../resources/educationfileresource.md), [educationLinkResource](../resources/educationlinkresource.md), [educationPowerPointResource](../resources/educationpowerpointresource.md), [educationWordResource](../resources/educationwordresource.md), [educationMediaResource](../resources/educationmediaresource.md) and [educationExternalResource](../resources/educationexternalresource.md).
+A base class for [educationExcelResource](../resources/educationexcelresource.md), [educationFileResource](../resources/educationfileresource.md), [educationLinkResource](../resources/educationlinkresource.md), [educationPowerPointResource](../resources/educationpowerpointresource.md), [educationWordResource](../resources/educationwordresource.md), [educationMediaResource](../resources/educationmediaresource.md), [educationExternalResource](../resources/educationexternalresource.md) and [educationTeamsAppResource](../resources/educationteamsappresource.md).
An educationResource is associated with an [assignment](educationassignment.md) and/or [submission](educationsubmission.md), which represents the learning object that is being handed out or handed in. You cannot instantiate a resource directly; you must make a subclass that will represent the type of resource being used.
v1.0 Educationteamsappresource https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/educationteamsappresource.md
+
+ Title: "educationTeamsAppResource resource type"
+description: "Corresponds to an [installed Microsoft Teams app](teamsappinstallation.md). This allows education service users to create and share assignments with embedded Teams applications."
+
+ms.localizationpriority: medium
++
+# educationTeamsAppResource resource type
+
+Namespace: microsoft.graph
++
+An education resource that corresponds to an [installed Microsoft Teams app](teamsappinstallation.md). This allows education service users to create and share assignments with embedded Teams applications, such as YouTube or FlipGrid.
+
+For information about using FlipGrid for education on Microsoft Teams, see [introduction to FlipGrid](https://education.microsoft.com/en-us/resource/13cb22b1).
+
+Inherites from [educationResource](educationresource.md).
+
+## Properties
+| Property | Type |Description|
+|:|:--|:-|
+|displayName|string|The display name of the resource.|
+|appId|string|Teams App ID of the application.|
+|appIconWebUrl|string|URL that points to the app's icon.|
+|teamsEmbeddedContentUrl|string|URL for the app resource that will be opened by Teams.|
+|webUrl|string|URL for the app resource that can be opened in the browser.|
+|createdBy|String|The display name of the user that created this resource. Inherited from **educationResource**.|
+|createdDateTime|DateTimeOffset|Date time the resoruce was added. Inherited from **educationResource**.|
+|lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource. Inherited from **educationResource**.|
+|lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from **educationResource**.|
++
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+
+ ],
+ "@odata.type": "microsoft.graph.educationTeamsAppResource"
+}-->
+
+```json
+{
+ "displayName": "String",
+ "appId": "Unique String",
+ "appIconWebUrl": "String URL",
+ "teamsEmbeddedContentUrl": "String URL",
+ "webUrl": "String URL",
+ "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
+ "createdDateTime": "String (timestamp)",
+ "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
+ "lastModifiedDateTime": "String (timestamp)"
+}
+
+```
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "educationExcelResource resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": []
+}
+-->
++
v1.0 Social Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/social-overview.md
Feature: Analytics (preview)
Use the analytics API to get activity statistics and related settings for a user: -- [settings](../resources/settings.md): For the analytics API to return results for a user, the current user analytics settings must show a valid MyAnalytics license, be opted in to using MyAnalytics, and have a cloud-hosted mailbox thatΓÇÖs graph-enabled.
+- [settings](../resources/settings.md): For the analytics API to return results for a user, the current user analytics settings must show a valid Microsoft Viva Insights license, be opted in to using Viva Insights, and have a cloud-hosted mailbox thatΓÇÖs graph-enabled.
- [activityStatistics](../resources/activitystatistics.md): Gets data for the last complete week (or the specified time range) for the Microsoft 365 activities that a user spent time on, including the number of hours spent on [calls](callactivitystatistics.md), [chats (instant messages)](chatactivitystatistics.md), [email](emailactivitystatistics.md), and [meetings](meetingactivitystatistics.md) during and outside of working hours and the number of hours available for [focused work](focusactivitystatistics.md). ## What's new
v1.0 Subjectrightsrequest Subjectrightsrequestapioverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/subjectrightsrequest-subjectrightsrequestapioverview.md
Title: "Use the Microsoft Graph subject rights request API"
-description: "The Microsoft 365 subject rights request API provides functionality for organizations to automate repetitive tasks and integrate with their existing subject rights request tools to build repeatable workflows that can help meet industry regulations."
+description: "The subject rights request API provides functionality for organizations to automate repetitive tasks and integrate with their existing subject rights request tools to build repeatable workflows that can help meet industry regulations."
ms.localizationpriority: medium ms.prod: "compliance"
doc_type: conceptualPageType
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-In accordance with certain privacy regulations around the world, individuals can make requests to review or manage the personal data about themselves that companies have collected. These requests are referred to as subject rights requests within the Microsoft 365 privacy management solution; they are sometimes also referred to as data subject requests (DSRs) or data subject access requests (DSARs). Microsoft 365 privacy management empowers personnel responsible for fulfilling subject rights requests to easily identify data subjects and find their personal information among an organizationΓÇÖs data in Exchange, SharePoint, OneDrive, and Teams.
+In accordance with certain privacy regulations around the world, individuals can make requests to review or manage the personal data about themselves that companies have collected. These requests are referred to as subject rights requests within the Microsoft Priva solution; they are sometimes also referred to as data subject requests (DSRs) or data subject access requests (DSARs). Microsoft Priva empowers personnel responsible for fulfilling subject rights requests to easily identify data subjects and find their personal information among an organizationΓÇÖs data in Exchange, SharePoint, OneDrive, and Teams.
The Microsoft Graph APIs for subject rights request provide functionality for organizations to automate repetitive tasks and integrate with existing data subject request tools, to enable building repeatable workflows that can be incorporated to their business processes. You can use the subject rights request APIs to help you automate and scale your organization's ability to perform subject rights requests searches in Microsoft 365 and help meet industry regulations more efficiently.
v1.0 Subjectrightsrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/subjectrightsrequest.md
Inherits from [entity](../resources/entity.md).
|:|:|:| |assignedTo|[identity](../resources/identity.md)|Identity that the request is assigned to.| |closedDateTime|DateTimeOffset|The date and time when the request was closed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
+| contentQuery | String | KQL based content query that should be used for search. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
|createdBy|[identitySet](../resources/identityset.md)|Identity information for the entity that created the request.| |createdDateTime|DateTimeOffset|The date and time when the request was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. | |dataSubject|[dataSubject](../resources/datasubject.md)|Information about the data subject.| |dataSubjectType|dataSubjectType|The type of the data subject. Possible values are: `customer`, `currentEmployee`, `formerEmployee`, `prospectiveEmployee`, `student`, `teacher`, `faculty`, `other`, `unknownFutureValue`.| |description|String|Description for the request.| |displayName|String|The name of the request.|
-|history|[subjectRightsRequestHistory](../resources/subjectRightsRequesthistory.md) collection|Collection of history change events.|
-|insight|[subjectRightsRequestDetail](../resources/subjectRightsRequestdetail.md)|Insight about the request.|
+| externalId | String| The external ID for the request that is immutable after creation and is used for tracking the request for the external system. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
+|history|[subjectRightsRequestHistory](../resources/subjectrightsrequesthistory.md) collection|Collection of history change events.|
+| includeAllVersions | Boolean | Include all versions of the documents. By default, the current copies of the documents will be returned. If SharePoint sites have versioning enabled, including all versions will include the historical copies of the documents. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
+| includeAuthoredContent| Boolean | Include content authored by the data subject. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
+|insight|[subjectRightsRequestDetail](../resources/subjectrightsrequestdetail.md)|Insight about the request.|
|internalDueDateTime|DateTimeOffset|The date and time when the request is internally due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| |lastModifiedBy|[identitySet](../resources/identityset.md)|Identity information for the entity that last modified the request.| |lastModifiedDateTime|DateTimeOffset|The date and time when the request was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
+| mailboxLocations | [subjectRightsRequestMailboxLocation](../resources/subjectrightsrequestmailboxlocation.md)|The mailbox locations that should be searched. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
+| pauseAfterEstimate | Boolean| Pause the request after estimate has finished. By default, the data estimate will run and then pause, allowing you to preview results and then select the option to retrieve data in the UI. You can set this property to `false` if you want it to perform the estimate and then automatically begin with the retrieval of the content. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
|regulations|String collection|List of regulations that this request will fulfill.|
-|stages|[subjectRightsRequestStageDetail](../resources/subjectRightsRequeststagedetail.md) collection|Information about the different stages for the request.|
-|status|subjectRightsRequestStatus|The status of the request.. Possible values are: `active`, `closed`, `unknownFutureValue`.|
+| siteLocations| [subjectRightsRequestSiteLocation](../resources/subjectrightsrequestsitelocation.md)| The SharePoint and OneDrive site locations that should be searched. This property is defined only for APIs accessed using the `\security` query path and not the `\privacy` query path.|
+|stages|[subjectRightsRequestStageDetail](../resources/subjectrightsrequeststagedetail.md) collection|Information about the different stages for the request.|
+|status|subjectRightsRequestStatus|The status of the request. Possible values are: `active`, `closed`, `unknownFutureValue`.|
|type|subjectRightsRequestType|The type of the request. Possible values are: `export`, `delete`, `access`, `tagForAction`, `unknownFutureValue`.| ## Relationships |Relationship|Type|Description| |:|:|:|
-|notes|[authoredNote](../resources/authorednote.md) collection|List of notes associcated with the request.|
+|notes|[authoredNote](../resources/authorednote.md) collection|List of notes associated with the request.|
|team|[team](../resources/team.md)|Information about the Microsoft Teams team that was created for the request.| ## JSON representation
The following is a JSON representation of the resource.
--> ``` json {
- "@odata.type": "#microsoft.graph.subjectRightsRequest",
- "type": "access",
+ "@odata.type": "#microsoft.graph.subjectRightsRequest",
+ "contentQuery": "String",
+ "closedDateTime": "String (timestamp)",
+ "createdBy": {
+ "@odata.type": "microsoft.graph.identitySet"
+ },
+ "createdDateTime": "String (timestamp)",
+ "dataSubject": {
+ "@odata.type": "microsoft.graph.dataSubject"
+ },
"dataSubjectType": "customer",
- "regulations": [
- "String"
- ],
- "displayName": "String",
"description": "String",
- "status": "active",
+ "displayName": "String",
+ "externalId": "String",
+ "id": "String (identifier)",
+ "includeAllVersions": "Boolean",
+ "includeAuthoredContent": "Boolean",
+ "insight": {
+ "@odata.type": "microsoft.graph.subjectRightsRequestDetail"
+ },
"internalDueDateTime": "String (timestamp)",
- "closedDateTime": "String (timestamp)",
+ "lastModifiedBy": {
+ "@odata.type": "microsoft.graph.identitySet"
+ },
"lastModifiedDateTime": "String (timestamp)",
- "id": "String (identifier)",
- "createdDateTime": "String (timestamp)",
+ "mailboxLocations": {
+ "@odata.type": "microsoft.graph.subjectRightsRequestMailboxLocation"
+ },
+ "pauseAfterDownload": "Boolean",
+ "regulations": [
+ "String"
+ ],
"stages": [ { "stage": "contentRetrieval", "status": "completed",
- "error":
- {
+ "error": {
"@odata.type": "microsoft.graph.publicError" } }, { "stage": "contentReview", "status": "current",
- "error":
- {
+ "error": {
"@odata.type": "microsoft.graph.publicError" } }, { "stage": "generateReport", "status": "notStarted",
- "error":
- {
+ "error": {
"@odata.type": "microsoft.graph.publicError" } }, { "stage": "caseResolved", "status": "notStarted",
- "error":
- {
+ "error": {
"@odata.type": "microsoft.graph.publicError" } } ],
- "insight": {
- "@odata.type": "microsoft.graph.subjectRightsRequestDetail"
- },
- "createdBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "lastModifiedBy": {
- "@odata.type": "microsoft.graph.identitySet"
- },
- "dataSubject": {
- "@odata.type": "microsoft.graph.dataSubject",
+ "siteLocations": {
+ "@odata.type": "microsoft.graph.subjectRightsRequestSiteLocation"
},
+ "status": "active",
"team": { "@odata.type": "microsoft.graph.team"
- }
+ },
+ "type": "access"
} ```
v1.0 Subjectrightsrequestallmailboxlocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/subjectrightsrequestallmailboxlocation.md
+
+ Title: "subjectRightsRequestAllMailboxLocation resource type"
+description: "Represents the properties for a subject rights request that defines all mailboxes (Exchange mailboxes and individual or group Microsoft Teams chats) as a search location."
+
+ms.localizationpriority: medium
++
+# subjectRightsRequestAllMailboxLocation resource type
+
+Namespace: microsoft.graph
++
+Represents the properties for a subject rights request that defines all mailboxes (Exchange mailboxes and individual or group Microsoft Teams chats) as a search location.
+
+Inherits from [subjectRightsRequestMailboxLocation](../resources/subjectrightsrequestmailboxlocation.md).
+
+## Properties
+None.
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.subjectRightsRequestAllMailboxLocation"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.subjectRightsRequestAllMailboxLocation"
+}
+```
+
v1.0 Subjectrightsrequestallsitelocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/subjectrightsrequestallsitelocation.md
+
+ Title: "subjectRightsRequestAllSiteLocation resource type"
+description: "Represents the properties for a subject rights request that defines all sites (SharePoint sites, OneDrive for Business sites, and Microsoft Teams channels) as a search location."
+
+ms.localizationpriority: medium
++
+# subjectRightsRequestAllSiteLocation resource type
+
+Namespace: microsoft.graph
++
+Represents the properties for a subject rights request that defines all sites (SharePoint sites, OneDrive for Business sites, and Microsoft Teams channels) as a search location. Use this type when you want to look for data in all sites.
+
+Inherits from [subjectRightsRequestSiteLocation](../resources/subjectrightsrequestsitelocation.md).
+
+## Properties
+None.
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.subjectRightsRequestAllSiteLocation"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.subjectRightsRequestAllSiteLocation"
+}
+```
+
v1.0 Subjectrightsrequestenumeratedmailboxlocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/subjectrightsrequestenumeratedmailboxlocation.md
+
+ Title: "subjectRightsRequestEnumeratedMailboxLocation resource type"
+description: "Represents the properties for a subject rights request that defines specific mailboxes (Exchange mailboxes and individual or group Microsoft Teams chats) as a search location."
+
+ms.localizationpriority: medium
++
+# subjectRightsRequestEnumeratedMailboxLocation resource type
+
+Namespace: microsoft.graph
++
+Represents the properties for a subject rights request that defines specific mailboxes (Exchange mailboxes and individual or group Microsoft Teams chats) as a search location.
+
+Inherits from [subjectRightsRequestMailboxLocation](../resources/subjectrightsrequestmailboxlocation.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|upns|String collection|Collection of mailboxes that should be included in the search. Includes the UPN (user principal name) of each mailbox, for example, `Monica.Thompson@contoso.com`.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.subjectRightsRequestEnumeratedMailboxLocation"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.subjectRightsRequestEnumeratedMailboxLocation",
+ "upns": [
+ "String"
+ ]
+}
+```
+
v1.0 Subjectrightsrequestenumeratedsitelocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/subjectrightsrequestenumeratedsitelocation.md
+
+ Title: "subjectRightsRequestEnumeratedSiteLocation resource type"
+description: "Represents the properties for a subject rights request that defines specific sites (SharePoint sites, OneDrive for Business sites, and Microsoft Teams channels) as a search location."
+
+ms.localizationpriority: medium
++
+# subjectRightsRequestEnumeratedSiteLocation resource type
+
+Namespace: microsoft.graph
++
+Represents the properties for a subject rights request that defines specific sites (SharePoint sites, OneDrive for Business sites, and Microsoft Teams channels) as a search location.
+
+Inherits from [subjectRightsRequestSiteLocation](../resources/subjectrightsrequestsitelocation.md).
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|urls|String collection|Collection of site URLs that should be included. Includes the URL of each site, for example, `https://www.contoso.com/site1`.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.subjectRightsRequestEnumeratedSiteLocation"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.subjectRightsRequestEnumeratedSiteLocation",
+ "urls": [
+ "String"
+ ]
+}
+```
+
v1.0 Subjectrightsrequestmailboxlocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/subjectrightsrequestmailboxlocation.md
+
+ Title: "subjectRightsRequestMailboxLocation resource type"
+description: "Represents an abstract base type for the properties of a mailbox location in a subject rights request."
+
+ms.localizationpriority: medium
++
+# subjectRightsRequestMailboxLocation resource type
+
+Namespace: microsoft.graph
++
+Represents an abstract base type for the properties of a mailbox location in a subject rights request.
+
+## Properties
+None.
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.subjectRightsRequestMailboxLocation"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.subjectRightsRequestMailboxLocation"
+}
+```
+
v1.0 Subjectrightsrequestsitelocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/subjectrightsrequestsitelocation.md
+
+ Title: "subjectRightsRequestSiteLocation resource type"
+description: "Represents an abstract base type for the properties of a site location in a subject rights request."
+
+ms.localizationpriority: medium
++
+# subjectRightsRequestSiteLocation resource type
+
+Namespace: microsoft.graph
++
+Represents an abstract base type for the properties of a site location in a subject rights request.
+
+## Properties
+None.
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.subjectRightsRequestSiteLocation"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.subjectRightsRequestSiteLocation"
+}
+```
+
v1.0 Channel List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/channel-list-messages.md
The following is an example of the request.
"name": "get_listchannelmessages_2" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages?top=3
+GET https://graph.microsoft.com/v1.0/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages?$top=3
Prefer: include-unknown-enum-members ```
v1.0 Educationassignment Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/educationassignment-setupresourcesfolder.md
POST /education/classes/{id}/assignments/{id}/setUpResourcesFolder
## Request headers | Header | Value | |:|:--|
-| Authorization | Bearer `{token}`. Required. |
+| Authorization | Bearer {token}. Required. |
## Request body
-You need to provide an empty json `{}` as request body for this method.
+In the request body, supply an empty JSON object `{}` for this method.
+ ## Response If successful, this method returns a `200 OK` response code and an [educationAssignment](/graph/api/resources/educationAssignment?view=graph-rest-1.0&preserve-view=true) object in the request body.
Content-type: application/json
### Response
-The following is an example of a response.
+The following is an example of the response.
<!-- { "blockType": "response",
v1.0 Complianceapioverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/complianceapioverview.md
Use the Microsoft Graph compliance and privacy APIs to build applications that:
## Subject rights request
-Privacy management provides powerful subject rights requests capabilities to help you handle requests from people seeking to manage their personal data within your organization. These requests are sometimes also referred to as data subject requests (DSRs), data subject access requests (DSARs), or consumer rights requests. Privacy management empowers personnel responsible for fulfilling subject rights requests to easily identify data subjects and find their personal information among your organizationΓÇÖs data in Exchange, SharePoint, OneDrive, and Teams. Learn more about [Microsoft 365 subject rights requests](/microsoft-365/compliance/privacy-management-subject-rights-requests).
+Microsoft Priva provides powerful subject rights requests capabilities to help you handle requests from people seeking to manage their personal data within your organization. These requests are sometimes also referred to as data subject requests (DSRs), data subject access requests (DSARs), or consumer rights requests. Microsoft Priva empowers personnel responsible for fulfilling subject rights requests to easily identify data subjects and find their personal information among your organizationΓÇÖs data in Exchange, SharePoint, OneDrive, and Teams. Learn more about [Priva Subject Rights Requests](/microsoft-365/compliance/privacy-management-subject-rights-requests).
-Explore the [Microsoft 365 subject rights request APIs](subjectrightsrequest-subjectrightsrequestapioverview.md).
+Explore the [subject rights request APIs](subjectrightsrequest-subjectrightsrequestapioverview.md).
v1.0 Subjectrightsrequest Subjectrightsrequestapioverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/subjectrightsrequest-subjectrightsrequestapioverview.md
Title: "Use the Microsoft Graph subject rights request API"
-description: "The Microsoft 365 subject rights request API provides functionality for organizations to automate repetitive tasks and integrate with their existing subject rights request tools to build repeatable workflows that can help meet industry regulations."
+description: "The subject rights request API provides functionality for organizations to automate repetitive tasks and integrate with their existing subject rights request tools to build repeatable workflows that can help meet industry regulations."
ms.localizationpriority: medium ms.prod: "compliance"
doc_type: conceptualPageType
# Use the Microsoft Graph subject rights request API
-In accordance with certain privacy regulations around the world, individuals can make requests to review or manage the personal data about themselves that companies have collected. These requests are referred to as subject rights requests within the Microsoft 365 privacy management solution; they are sometimes also referred to as data subject requests (DSRs) or data subject access requests (DSARs). Microsoft 365 privacy management empowers personnel responsible for fulfilling subject rights requests to easily identify data subjects and find their personal information among an organizationΓÇÖs data in Exchange, SharePoint, OneDrive, and Teams.
+In accordance with certain privacy regulations around the world, individuals can make requests to review or manage the personal data about themselves that companies have collected. These requests are referred to as subject rights requests within the Microsoft Priva solution; they are sometimes also referred to as data subject requests (DSRs) or data subject access requests (DSARs). Microsoft Priva empowers personnel responsible for fulfilling subject rights requests to easily identify data subjects and find their personal information among an organizationΓÇÖs data in Exchange, SharePoint, OneDrive, and Teams.
The Microsoft Graph APIs for subject rights request provide functionality for organizations to automate repetitive tasks and integrate with existing data subject request tools, to enable building repeatable workflows that can be incorporated to their business processes. You can use the subject rights request APIs to help you automate and scale your organization's ability to perform subject rights requests searches in Microsoft 365 and help meet industry regulations more efficiently.
v1.0 Subjectrightsrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/subjectrightsrequest.md
Inherits from [entity](../resources/entity.md).
|regulations|String collection|List of regulations that this request will fulfill.| |stages|[subjectRightsRequestStageDetail](../resources/subjectRightsRequeststagedetail.md) collection|Information about the different stages for the request.| |status|subjectRightsRequestStatus|The status of the request.. Possible values are: `active`, `closed`, `unknownFutureValue`.|
-|type|subjectRightsRequestType|The type of the request. Possible values are: `export`, `delete`, `access`, `tagForAction`, `unknownFutureValue`.|
+|type|subjectRightsRequestType|The type of the request. Possible values are: `export`, `delete`, `access`, `tagForAction`, `unknownFutureValue`.|
## Relationships |Relationship|Type|Description|