Updates from: 09/15/2021 03:10:51
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackageassignmentrequest Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentrequest-delete.md
+
+ Title: "Delete accessPackageAssignmentRequest"
+description: "Delete accessPackageAssignmentRequest."
+ms.localizationpriority: medium
+++
+# Delete accessPackageAssignmentRequest
+
+Namespace: microsoft.graph
++
+Delete an [accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) object.
+
+This request can be made to remove a denied or completed request. You cannot delete an access package assignment request if it has any **accessPackageAssignment** objects.
+
+## 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).
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | EntitlementManagement.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | EntitlementManagement.ReadWrite.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+DELETE /identityGovernance/entitlementManagement/accessPackageAssignmentRequests/{id}
+```
+
+## Request headers
+
+| Name | Description |
+|:--|:--|
+| Authorization | Bearer \{token\}. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code. It does not return anything in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_accesspackageassignmentrequest"
+}-->
+```http
+DELETE https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests/{id}
+```
+
+### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "Delete accessPackageAssignmentRequest",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
v1.0 Directory Deleteditems List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directory-deleteditems-list.md
Content-type: application/json
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_deleteditems_count"
Content-type: application/json
GET https://graph.microsoft.com/beta/directory/deletedItems/microsoft.graph.group?$count=true&$orderBy=deletedDateTime asc&$select=id,displayName,deletedDateTime ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Educationassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignment-get.md
Title: "Get educationAssignment"
-description: "Get the properties and relationships of a given assignment. Note that teachers and applications can see all assignments in a class."
+description: "Get the properties and relationships of an assignment."
ms.localizationpriority: medium ms.prod: "education"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the properties and relationships of an assignment.
+Get the properties and relationships of an [assignment](../resources/educationassignment.md).
Students can only see assignments assigned to them; teachers and applications with application permissions can see all assignments in a class.
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Authorization | Bearer {token}. Required. | ## Request body
-Do not supply a request body for this method.
+Don't supply a request body for this method.
## Response If successful, this method returns a `200 OK` response code and an [educationAssignment](../resources/educationassignment.md) object in the response body. ## Example
-##### Request
+### Request
The following is an example of the request. # [HTTP](#tab/http)- <!-- {
- "blockType": "request",
+ "blockType": "request",
+ "sampleKeys":["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","3c77de7f-539b-49e1-9c96-1274f2f0ee3b"],
"name": "get_educationassignment" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/11014/assignments/19002
+GET https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/3c77de7f-539b-49e1-9c96-1274f2f0ee3b
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationassignment-csharp-snippets.md)]
GET https://graph.microsoft.com/beta/education/classes/11014/assignments/19002
-##### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
Content-type: application/json
Content-length: 279 {
- "id": "19002",
- "addedStudentAction": "none",
- "addToCalendarAction": "studentsAndPublisher",
- "allowLateSubmissions": true,
- "allowStudentsToAddResourcesToSubmission": true,
- "assignDateTime": "String (timestamp)",
- "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
- "assignedDateTime": "2014-01-01T00:00:00Z",
- "classId": "11006",
- "createdBy": {
- "user": {
- "displayName": "Susana Rocha",
- "id": "14012",
- }
- },
- "closeDateTime": "2014-01-11T00:00:00Z",
- "createdDateTime": "2014-01-01T00:00:00Z",
- "displayName": "Mid term exam",
- "dueDateTime": "2014-01-11T00:00:00Z",
- "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!0sGAoOieeE6iSj1WXCV-nYYTuh2luKRDvUVGQBLOmvYpRzc5ARnCRorRht6P3MhU/items/01N74NOEZL7P3VK22SQFDKBZ3PHVPKDVAQ",
- "grading": {
- "@odata.type": "microsoft.graph.educationAssignmentPointsGradeType",
- "maxPoints": 100
- },
- "instructions": {
- "content": "Answer every question correctly",
- "contentType": "Text"
- },
- "lastModifiedBy": {
- "user": {
- "displayName": "Susana Rocha",
- "id": "14012",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('f4a941ff-9da6-4707-ba5b-0eae93cad0b4')/assignments/$entity",
+ "classId": "f4a941ff-9da6-4707-ba5b-0eae93cad0b4",
+ "displayName": "07.30 SubmissionsUploadResource Word2",
+ "closeDateTime": null,
+ "dueDateTime": "2021-08-01T06:59:00Z",
+ "assignDateTime": null,
+ "assignedDateTime": "2021-07-30T16:01:32.5518042Z",
+ "allowLateSubmissions": true,
+ "resourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeU6BLWBcGc_R6UgCKyYyTin/items/016XPCQECCTNQDGB5U4RCZFBXZBV5ZX24X",
+ "createdDateTime": "2021-07-30T16:00:52.1918016Z",
+ "lastModifiedDateTime": "2021-07-30T19:39:09.6384593Z",
+ "allowStudentsToAddResourcesToSubmission": true,
+ "status": "assigned",
+ "notificationChannelUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7b%22subEntityId%22%3a%22%7b%5c%22version%5c%22%3a%5c%221.0%5c%22%2c%5c%22config%5c%22%3a%7b%5c%22classes%5c%22%3a%5b%7b%5c%22id%5c%22%3a%5c%22f4a941ff-9da6-4707-ba5b-0eae93cad0b4%5c%22%2c%5c%22displayName%5c%22%3anull%2c%5c%22assignmentIds%5c%22%3a%5b%5c%223c77de7f-539b-49e1-9c96-1274f2f0ee3b%5c%22%5d%7d%5d%7d%2c%5c%22action%5c%22%3a%5c%22navigate%5c%22%2c%5c%22view%5c%22%3a%5c%22assignment-viewer%5c%22%7d%22%2c%22channelId%22%3anull%7d",
+ "addToCalendarAction": "none",
+ "addedStudentAction": "none",
+ "id": "3c77de7f-539b-49e1-9c96-1274f2f0ee3b",
+ "instructions": {
+ "content": "<div style=\"font-family: inherit; font-size: inherit; color: inherit;\">upload a word document</div>",
+ "contentType": "html"
+ },
+ "grading": {
+ "@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
+ "maxPoints": 10
+ },
+ "assignTo": {
+ "@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
+ },
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
}
- },
- "lastModifiedDateTime": "2014-01-01T00:00:00Z",
- "notificationChannelUrl": null,
- "status": "assigned"
} ```
v1.0 Educationassignment List Categories https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignment-list-categories.md
Title: "List categories"
-description: "List all the categories associated with this assignment."
+description: "List all the categories associated with an assignment."
ms.localizationpriority: medium ms.prod: "education"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-List all the categories associated with this assignment.
+List all the categories associated with an [assignment](../resources/educationassignment.md).
## 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).
This method supports the [OData query parameters](/graph/query-parameters) to he
| Authorization | Bearer {token}. Required. | ## Request body
-Do not supply a request body for this method.
+Don't supply a request body for this method.
+ ## Response If successful, this method returns a `200 OK` response code and collection of [educationCategory](../resources/educationcategory.md) objects in the response body.+ ## Example
-##### Request
+### Request
The following is an example of the request.+
+# [HTTP](#tab/http)
<!-- {
- "blockType": "ignored",
- "name": "get_submissions"
+ "blockType": "request",
+ "sampleKeys": ["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","9018ae7a-9953-4796-a152-4c54e0910922"],
+ "name": "get_assignment_categories"
}--> ```http
-GET https://graph.microsoft.com/beta/education/classes/95c15102-5f20-4ca1-8461-0673db4c70a1/assignments/9a5e4047-c1dc-4243-9628-580d3c64b80c/categories
+GET https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/9018ae7a-9953-4796-a152-4c54e0910922/categories
```
-##### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability. <!-- {
- "blockType": "ignored",
+ "blockType": "response",
"truncated": true, "@odata.type": "microsoft.graph.educationCategory", "isCollection": true
Content-type: application/json
Content-length: 873 {
- "value": [{
- "displayName": "Quizzes",
- "id": "ec98f158-341d-4fea-9f8c-14a250d489ac"
- }]
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('f4a941ff-9da6-4707-ba5b-0eae93cad0b4')/assignments('9018ae7a-9953-4796-a152-4c54e0910922')/categories",
+ "value": [
+ {
+ "displayName": "August Unit 2",
+ "id": "70563636-801f-440a-989e-14d417cc5c05"
+ }
+ ]
} ```
v1.0 Educationassignment List Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignment-list-resources.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get all the resources associated with an assignment.
+Get all the resources associated with an [assignment](../resources/educationassignment.md).
## 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 GET /education/classes/{id}/assignments/{id}/resources ```+ ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Authorization | Bearer {token}. Required. | ## Request body
-Do not supply a request body for this method.
+Don't supply a request body for this method.
+ ## Response If successful, this method returns a `200 OK` response code and a collection of [educationAssignmentResource](../resources/educationassignmentresource.md) objects in the response body.+ ## Example
-##### Request
+### Request
The following is an example of the request. # [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","9018ae7a-9953-4796-a152-4c54e0910922"],
"name": "get_resources_1" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/11012/assignments/19002/resources
+GET https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/9018ae7a-9953-4796-a152-4c54e0910922/resources
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-resources-1-csharp-snippets.md)]
GET https://graph.microsoft.com/beta/education/classes/11012/assignments/19002/r
-##### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
Content-type: application/json
Content-length: 1011 {
- "value": [
- {
- "distributeForStudentWork": false,
- "resource": {
- "@odata.type": "#microsoft.graph.educationLinkResource",
- "displayName": "Microsoft Homepage",
- "createdDateTime": "2017-10-21T07:52:45.5675913Z",
- "createdBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "lastModifiedDateTime": "2017-10-21T07:52:45.5675913Z",
- "lastModifiedBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "link": "https://www.microsoft.com"
- },
- "id": "850f51b7-1df9-4ec0-bd62-64a0214b9cbf"
- },
- {
- "distributeForStudentWork": true,
- "resource": {
- "@odata.type": "#microsoft.graph.educationWordResource",
- "displayName": "Report.docx",
- "createdDateTime": "2017-10-21T07:52:53.9863696Z",
- "createdBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "lastModifiedDateTime": "2017-10-21T07:52:53.9863696Z",
- "lastModifiedBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeTZ_iul5AdW9f/items/017NJZI27BCN2QI2H7HJGLIVPXR6SD2DH6"
- },
- "id": "f2387c3b-ec39-4bf2-a399-d7242677f024"
- }
- ]
+ "value": [
+ {
+ "distributeForStudentWork": false,
+ "id": "eec7f642-9d9a-406f-bbae-4b3b2c12e273",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationFileResource",
+ "displayName": "First file uploaded as Education resource by t-cristobalb",
+ "createdDateTime": "2021-07-16T23:41:53.9378423Z",
+ "lastModifiedDateTime": "2021-07-16T23:41:53.9378423Z",
+ "fileUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeU6BLWBcGc_R6UgCKyYyTin/items/016XPCQEA5VVDIMU4BSFG3VBI37MPHZ3OE",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ }
+ }
+ },
+ {
+ "distributeForStudentWork": false,
+ "id": "ceb3a7e7-158e-4164-9f80-104d14884389",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationPowerPointResource",
+ "displayName": "state diagram.pptx",
+ "createdDateTime": "2021-08-27T14:42:04.8778499Z",
+ "lastModifiedDateTime": "2021-08-27T14:42:04.8778499Z",
+ "fileUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeU6BLWBcGc_R6UgCKyYyTin/items/016XPCQEGRJFHRKPSI6RB3XQ6HGTB4L4FV",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ }
+ }
+ }
+ ]
} ```
v1.0 Educationassignment List Submissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignment-list-submissions.md
Title: "List submissions"
-description: "List all the submissions associated with this assignment. A teacher or an application with application permissions can get all the submissions while a student can only get submissions that they are associated with."
+description: "List all the submissions associated with an assignment."
ms.localizationpriority: medium ms.prod: "education"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-List all the submissions associated with this assignment. A teacher or an application with application permissions can get all the submissions while a student can only get submissions that they are associated with.
+List all the submissions associated with an [assignment](../resources/educationassignment.md).
+
+A teacher or an application with application permissions can get all the submissions while a student can only get submissions that they are associated with.
## 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 GET /education/classes/{id}/assignments/{id}/submissions ```+ ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Authorization | Bearer {token}. Required. | ## Request body
-Do not supply a request body for this method.
+Don't supply a request body for this method.
+ ## Response If successful, this method returns a `200 OK` response code and collection of [educationSubmission](../resources/educationsubmission.md) objects in the response body.+ ## Example
-##### Request
+### Request
The following is an example of the request. # [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","3c77de7f-539b-49e1-9c96-1274f2f0ee3b"],
"name": "get_submissions" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/submissions
+GET https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/3c77de7f-539b-49e1-9c96-1274f2f0ee3b/submissions
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-submissions-csharp-snippets.md)]
GET https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/s
-##### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
Content-type: application/json
Content-length: 873 {
- "value": [
- {
- "id": "33223",
- "recipient": {
- "userId": "13015",
- "@Odata.type":"microsoft.graph.educationSubmissionRecipient"
- },
- "releasedBy": {
- "user": {
- "displayName": "Susana Rocha",
- "id": "14012"
- },
- },
- "releasedDateTime": "2014-01-01T00:00:00Z",
- "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeT456457AdW9f/items/017NJZI25NOB5XZNLABF7646XAMDZTQQ6T",
- "status": "working",
- "submittedBy": {
- "user": {
- "displayName": "Susana Rocha",
- "id": "14012"
- },
- },
- "submittedDateTime": "2014-01-01T00:00:00Z"
- }
- ]
+ "value": [
+ {
+ "status": "working",
+ "submittedDateTime": null,
+ "unsubmittedDateTime": null,
+ "returnedDateTime": null,
+ "resourcesFolderUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEDJCE5LX4OXABF37QSORAK5WKQD",
+ "id": "4af73d2b-6b9c-493f-0688-979087bed39b",
+ "recipient": {
+ "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
+ "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ },
+ "submittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "displayName": null
+ }
+ },
+ "unsubmittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ }
+ }
+ ]
} ```
v1.0 Educationassignmentdefaults Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignmentdefaults-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Read the properties and relationships of an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object. These are the class-level assignment defaults respected by new assignments created in the class. Callers can continue to specify custom values on each assignment creation if they do not want the default behaviors.
+Read the properties and relationships of an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object.
+
+These are the class-level assignment defaults respected by new [assignments](../resources/educationassignment.md) created in the class. Callers can continue to specify custom values on each **assignment** creation if they don't want the default behaviors.
## 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).
This method supports some of the OData query parameters to help customize the re
|Authorization|Bearer {token}. Required.| ## Request body
-Do not supply a request body for this method.
+Don't supply a request body for this method.
## Response If successful, this method returns a `200 OK` response code and an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object in the response body.
-## Examples
+## Example
### Request # [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["72a7baec-c3e9-4213-a850-f62de0adad5f"],
"name": "get_educationassignmentdefaults" } --> ``` http
-GET https://graph.microsoft.com/beta/education/classes/{id}/assignmentDefaults
+GET https://graph.microsoft.com/beta/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignmentDefaults
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationassignmentdefaults-csharp-snippets.md)]
HTTP/1.1 200 OK
Content-Type: application/json {
- "value": {
- "addedStudentAction": "none",
- "addToCalendarAction": "studentsAndTeamOwners",
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignmentDefaults/$entity",
"dueTime": "23:59:00",
- "notificationChannelUrl": "https://graph.microsoft.com/beta/teams('id')/channels('id')"
- }
+ "notificationChannelUrl": null,
+ "addedStudentAction": "none",
+ "addToCalendarAction": "none"
} ```
v1.0 Educationassignmentresource Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignmentresource-get.md
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the properties of a specific resource on an assignment.
+Get the properties of a specific resource on an [assignment](../resources/educationassignment.md).
+ ## 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).
This method supports the [OData Query Parameters](/graph/query-parameters) to he
| Authorization | Bearer {token}. Required. | ## Request body
-Do not supply a request body for this method.
+Don't supply a request body for this method.
+ ## Response If successful, this method returns a `200 OK` response code and an [educationAssignmentResource](../resources/educationassignmentresource.md) object in the response body.+ ## Example
-##### Request
+### Request
The following is an example of the request. + # [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_educationassignmentresource" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/resources/22002
+GET https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/9018ae7a-9953-4796-a152-4c54e0910922/resources/eec7f642-9d9a-406f-bbae-4b3b2c12e273
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationassignmentresource-csharp-snippets.md)]
GET https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/r
-##### Response
+### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
Content-type: application/json
Content-length: 842 {
- "distributeForStudentWork": true,
- "id": "22002",
- "resource": {
- "createdBy": {
- "user": {
- "displayName": "Susana Rocha",
- "id": "14012"
- },
- },
- "createdDateTime": "2014-01-01T00:00:00Z",
- "displayName": "Excel workbook 1",
- "lastModifiedBy": {
- "user": {
- "displayName": "Susana Rocha",
- "id": "14012"
- },
- },
- "lastModifiedDateTime": "2014-01-01T00:00:00Z"
- }
+ "distributeForStudentWork": false,
+ "id": "eec7f642-9d9a-406f-bbae-4b3b2c12e273",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationFileResource",
+ "displayName": "First file uploaded as Education resource by t-cristobalb",
+ "createdDateTime": "2021-07-16T23:41:53.9378423Z",
+ "lastModifiedDateTime": "2021-07-16T23:41:53.9378423Z",
+ "fileUrl": "https://graph.microsoft.com/beta/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeU6BLWBcGc_R6UgCKyYyTin/items/016XPCQEA5VVDIMU4BSFG3VBI37MPHZ3OE",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ }
+ }
} ```
v1.0 Educationassignmentsettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignmentsettings-get.md
This method supports some of the OData query parameters to help customize the re
|Authorization|Bearer {token}. Required.| ## Request body
-Do not supply a request body for this method.
+Don't supply a request body for this method.
## Response If successful, this method returns a `200 OK` response code and an [educationAssignmentSettings](../resources/educationassignmentsettings.md) object in the response body.
-## Examples
+## Example
### Request
If successful, this method returns a `200 OK` response code and an [educationAss
} --> ``` http
-GET https://graph.microsoft.com/beta/education/classes/{id}/assignmentSettings
+GET https://graph.microsoft.com/beta/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignmentsettings
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationassignmentsettings-csharp-snippets.md)]
HTTP/1.1 200 OK
Content-Type: application/json {
- "value": {
"submissionAnimationDisabled": false
- }
} ```
v1.0 Group Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-get.md
HTTP/1.1 200 OK
Content-type: application/json {
- "id": "45b7d2e7-b882-4a80-ba97-10b7a63b8fa4",
- "deletedDateTime": null,
- "classification": null,
- "createdDateTime": "2018-12-22T02:21:05Z",
- "description": "Self help community for golf",
- "displayName": "Golf Assist",
- "expirationDateTime": null,
- "groupTypes": [
- "Unified"
- ],
- "isAssignableToRole": null,
- "mail": "golfassist@contoso.com",
- "mailEnabled": true,
- "mailNickname": "golfassist",
- "membershipRule": null,
- "membershipRuleProcessingState": null,
- "onPremisesLastSyncDateTime": null,
- "onPremisesSecurityIdentifier": null,
- "onPremisesSyncEnabled": null,
- "preferredDataLocation": "CAN",
- "preferredLanguage": null,
- "proxyAddresses": [
- "smtp:golfassist@contoso.onmicrosoft.com",
- "SMTP:golfassist@contoso.com"
- ],
- "renewedDateTime": "2018-12-22T02:21:05Z",
- "resourceBehaviorOptions": [],
- "resourceProvisioningOptions": [],
- "securityEnabled": false,
- "theme": null,
- "visibility": "Public",
- "onPremisesProvisioningErrors": []
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups/$entity",
+ "@odata.id": "https://graph.microsoft.com/v2/45b7d2e7-b882-4a80-ba97-10b7a63b8fa4/directoryObjects/4de51a22-3289-4ea5-bbdb-8503ea644f1b/Microsoft.DirectoryServices.Group",
+ "id": "4de51a22-3289-4ea5-bbdb-8503ea644f1b",
+ "deletedDateTime": null,
+ "classification": null,
+ "createdDateTime": "2021-09-13T10:07:01Z",
+ "createdByAppId": "de8bc8b5-d9f9-48b1-a8ad-b748da725064",
+ "organizationId": "45b7d2e7-b882-4a80-ba97-10b7a63b8fa4",
+ "description": "Self help community for library",
+ "displayName": "Library Assist",
+ "expirationDateTime": "2022-01-11T10:07:01Z",
+ "groupTypes": [
+ "Unified"
+ ],
+ "infoCatalogs": [],
+ "isAssignableToRole": null,
+ "isManagementRestricted": null,
+ "mail": "library@contoso.com",
+ "mailEnabled": true,
+ "mailNickname": "library",
+ "membershipRule": null,
+ "membershipRuleProcessingState": null,
+ "onPremisesDomainName": null,
+ "onPremisesLastSyncDateTime": null,
+ "onPremisesNetBiosName": null,
+ "onPremisesSamAccountName": null,
+ "onPremisesSecurityIdentifier": null,
+ "onPremisesSyncEnabled": null,
+ "preferredDataLocation": "EU",
+ "preferredLanguage": null,
+ "proxyAddresses": [
+ "SPO:SPO_0dbffe23-f6fb-4478-adcd-880daf88bb12@SPO_45b7d2e7-b882-4a80-ba97-10b7a63b8fa4",
+ "SMTP:library@contoso.com"
+ ],
+ "renewedDateTime": "2021-09-13T10:07:01Z",
+ "resourceBehaviorOptions": [],
+ "resourceProvisioningOptions": [],
+ "securityEnabled": false,
+ "securityIdentifier": "S-1-12-1-1306860066-1319449225-59104187-458188010",
+ "theme": null,
+ "visibility": "Public",
+ "writebackConfiguration": {
+ "isEnabled": null,
+ "onPremisesGroupType": null
+ },
+ "onPremisesProvisioningErrors": []
} ```
v1.0 Identitycontainer Post B2cuserflows https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identitycontainer-post-b2cuserflows.md
In the request body, provide a JSON representation of a [b2cIdentityUserFlow](..
|Property|Type|Description| |:|:--|:-|
-|id|String|Required. The name of the user flow. The name will be pre-pended with `B2C_1` after creation.|
+|id|String|Required. The name of the user flow. The name will be pre-pended with `B2C_1_` after creation if the prefix was not added to the name during your request. |
|userFlowType|String|Required. The type of user flow you are creating. The supported values for **userFlowType** are:<br/><ul><li>`signUp`</li><li>`signIn`</li><li>`signUpOrSignIn`</li><li>`passwordReset`</li><li>`profileUpdate`</li><li>`resourceOwner`</li>| |userFlowTypeVersion|Float|Required. The version of the user flow.| |isLanguageCustomizationEnabled|Boolean|Optional. Determines whether language customization is enabled within the Azure AD B2C user flow. Language customization is not enabled by default for Azure AD B2C user flows.|
In the request body, provide a JSON representation of a [b2cIdentityUserFlow](..
## Response
-If successful, this method returns a `201 Created` response code and a Location header with a URI to the [b2cIdentityUserFlow](../resources/b2cidentityuserflow.md) object created for this request, with the `B2C_1` prefix added to the name. If unsuccessful, a `4xx` error will be returned with specific details.
+If successful, this method returns a `201 Created` response code and a Location header with a URI to the [b2cIdentityUserFlow](../resources/b2cidentityuserflow.md) object created for this request, with the `B2C_1_` prefix added to the name. If unsuccessful, a `4xx` error will be returned with specific details.
## Examples
The following is an example of the request.
``` http POST https://graph.microsoft.com/beta/identity/b2cUserFlows Content-type: application/json
-Content-length: 154
{ "id": "Customer",
The following is an example of the response.
```http HTTP/1.1 201 Created
-Location: https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_Customer
+Location: https://graph.microsoft.com/beta/identity/b2cUserFlows('B2C_1_Customer')
Content-type: application/json {
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/b2cUserFlows/$entity",
"id": "B2C_1_Customer", "userFlowType": "signUpOrSignIn", "userFlowTypeVersion": 3, "isLanguageCustomizationEnabled": false,
- "defaultLanguageTag": "en"
+ "defaultLanguageTag": "en",
+ "authenticationMethods": "emailWithPassword",
+ "tokenClaimsConfiguration": {
+ "isIssuerEntityUserFlow": false
+ },
+ "apiConnectorConfiguration": {}
} ```
The following is an example of the request.
``` http POST https://graph.microsoft.com/beta/identity/b2cUserFlows
+Location: https://graph.microsoft.com/beta/identity/b2cUserFlows('B2C_1_Customer')
Content-type: application/json
-Content-length: 154
{ "id": "Customer",
Content-length: 154
"userFlowTypeVersion": 3, "identityProviders": [ {
- "id": "Facebook-OAuth",
- "type": "Facebook",
- "Name": "Facebook"
+ "id": "Facebook-OAuth"
} ] }
The following is an example of the response.
```http HTTP/1.1 201 Created
-Location: https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_Customer
Content-type: application/json {
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/b2cUserFlows/$entity",
"id": "B2C_1_Customer", "userFlowType": "signUpOrSignIn", "userFlowTypeVersion": 3, "isLanguageCustomizationEnabled": false,
- "defaultLanguageTag": "en"
+ "defaultLanguageTag": "en",
+ "authenticationMethods": "0",
+ "tokenClaimsConfiguration": {
+ "isIssuerEntityUserFlow": false
+ },
+ "apiConnectorConfiguration": {}
} ```
v1.0 Identityuserflowattribute List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identityuserflowattribute-list.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account)|IdentityUserFlow.Read.All, IdentityUserflow.ReadWrite.All|
+|Delegated (work or school account)|IdentityUserFlow.Read.All, IdentityUserFlow.ReadWrite.All|
|Delegated (personal Microsoft account)| Not supported.| |Application|IdentityUserFlow.Read.All, IdentityUserFlow.ReadWrite.All|
v1.0 Participant Startholdmusic https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/participant-startholdmusic.md
The following example shows how to call this API.
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "participant-startHoldMusic"
Content-type: application/json
"clientContext": "d45324c1-fcb5-430a-902c-f20af696537c", } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
v1.0 Participant Stopholdmusic https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/participant-stopholdmusic.md
The following example shows how to call this API.
The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "participant-stopHoldMusic"
Content-type: application/json
"clientContext": "d45324c1-fcb5-430a-902c-f20af696537c", } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
v1.0 Samlorwsfedexternaldomainfederation Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-delete.md
If successful, this method returns a `204 No Content` response code.
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_samlorwsfedexternaldomainfederation"
If successful, this method returns a `204 No Content` response code.
``` http DELETE https://graph.microsoft.com/beta/directory/federationConfigurations/96db02e2-80c1-5555-bc3a-de92ffb8c5be ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Samlorwsfedexternaldomainfederation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-get.md
If successful, this method returns a `200 OK` response code and a [samlOrWsFedEx
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_samlorwsfedexternaldomainfederation"
If successful, this method returns a `200 OK` response code and a [samlOrWsFedEx
``` http GET https://graph.microsoft.com/beta/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation?$filter=domains/any(x: x/id eq 'contoso.com') ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Samlorwsfedexternaldomainfederation List Domains https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-list-domains.md
If successful, this method returns a `200 OK` response code and a collection of
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_externaldomainname"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation/f1e11a04-0244-4592-99df-b01cfaadce15/domains ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Samlorwsfedexternaldomainfederation List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-list.md
If successful, this method returns a `200 OK` response code and a collection of
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_samlorwsfedexternaldomainfederation"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/beta/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Samlorwsfedexternaldomainfederation Post Domains https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-post-domains.md
If successful, this method returns a `201 Created` response code and an [externa
### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_externaldomainname_from_"
Content-length: 60
"id": "contososuites.com" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response The following is an example of the response.
v1.0 Samlorwsfedexternaldomainfederation Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-post.md
If successful, this method returns a `201 Created` response code and a [samlOrWs
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_samlorwsfedexternaldomainfederation_from_"
Content-length: 283
"signingCertificate": "MIIDADCCAeigAwIBAgIQEX41y8r6" } ```
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response The following is an example of the response.
v1.0 Samlorwsfedexternaldomainfederation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-update.md
If successful, this method returns a `200 OK` response code and an updated [saml
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_samlorwsfedexternaldomainfederation"
Content-Type: application/json
```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Schemaextension Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/schemaextension-delete.md
Do not supply a request body for this method.
If successful, this method returns `204 No Content` response code. It does not return anything in the response body. ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
DELETE https://graph.microsoft.com/beta/schemaExtensions/{id}
-##### Response
-Here is an example of the response.
+### Response
+The following is an example of the response.
<!-- { "blockType": "response", "truncated": true
v1.0 Schemaextension Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/schemaextension-get.md
One of the following permissions is required to call this API. To learn more, in
```http GET /schemaExtensions/{id} ```
-## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
## Request headers | Name |Description|
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and [schemaExtension](../resources/schemaextension.md) object in the response body. ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/schemaExtensions/graphlearn_test
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response. Note: The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 201
{ "id":"graphlearn_test",
v1.0 Schemaextension List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/schemaextension-list.md
One of the following permissions is required to call this API. To learn more, in
```http GET /schemaExtensions ```
-## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
## Request headers | Name |Description|
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [schemaExtension](../resources/schemaextension.md) objects in the response body. ## Example
-##### Request
+### Request
The following example shows how to look among all the accessible extensions for a specific one by filtering on its unique **id**. # [HTTP](#tab/http)
GET https://graph.microsoft.com/beta/schemaExtensions?$filter=id%20eq%20'graphle
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 274
{ "value": [
v1.0 Schemaextension Post Schemaextensions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/schemaextension-post-schemaextensions.md
If successful, this method returns `201 Created` response code and [schemaExtens
#### Request
-This example shows using a verified domain name, `graphlearn`, and a schema name, `courses`, to form a unique string for the **id** property of the
-schema extension definition. The unique string is based on this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}.
+The following example shows using a verified domain name, `graphlearn`, and a schema name, `courses`, to form a unique string for the **id** property of the schema extension definition. The unique string is based on this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}.
In the request body, supply a JSON representation of the [schemaExtension](../resources/schemaextension.md) object.
Content-type: application/json
#### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 201 Created Content-type: application/json
-Content-length: 420
{ "id": "graphlearn_courses",
Content-length: 420
#### Request
-This example shows specifying just a schema name, `courses`, in the **id** property in the request, together with the JSON representation of the rest of the
-properties in the [schemaExtension](../resources/schemaextension.md) object. Microsoft Graph will assign and return a unique string value in the response.
+The following example shows specifying just a schema name, `courses`, in the **id** property in the request, together with the JSON representation of the rest of the properties in the [schemaExtension](../resources/schemaextension.md) object. Microsoft Graph will assign and return a unique string value in the response.
# [HTTP](#tab/http)
Content-type: application/json
#### Response The response includes a unique string in the **id** property that is based on the schema name provided in the request, together with the rest of the newly created schema definition.
-The value in **id** in the response is based on the format, ext\{_&#65279;8-random-alphanumeric-chars_\}\_\{_&#65279;schema-name_\}.
-Note: The response object shown here might be shortened for readability.
+The value in **id** in the response is based on the format, ext\{_&#65279;8-random-alphanumeric-chars_\}\_\{_&#65279;schema-name_\}.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Note: The response object shown here might be shortened for readability.
```http HTTP/1.1 201 Created Content-type: application/json
-Content-length: 420
{ "id": "extk9eruy7c_courses",
Content-length: 420
#### Request
-This example shows how to create a schema extension setting the **owner**. In this scenario, the user of the application might not be the owner of the application (for example if you are using Microsoft Graph Explorer). In this case you should set the **owner** property to the **appId** of an application you own, otherwise you won't be authorized to create a schema extension. Set the **owner** property in the request, together with the JSON representation of the rest of the
-properties in the [schemaExtension](../resources/schemaextension.md) object.
+The following example shows how to create a schema extension setting the **owner**. In this scenario, the user of the application might not be the owner of the application (for example if you are using Microsoft Graph Explorer). In this case you should set the **owner** property to the **appId** of an application you own, otherwise you won't be authorized to create a schema extension. Set the **owner** property in the request, together with the JSON representation of the rest of the properties in the [schemaExtension](../resources/schemaextension.md) object.
# [HTTP](#tab/http)
Content-type: application/json
#### Response
-The response includes the **owner** set to the supplied value in the request.
-Note: The response object shown here might be shortened for readability.
+The response includes the **owner** set to the value supplied in the request.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Note: The response object shown here might be shortened for readability.
```http HTTP/1.1 201 Created Content-type: application/json
-Content-length: 420
{ "id": "extk9eruy7c_courses",
v1.0 Schemaextension Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/schemaextension-update.md
In the request body, supply the values for relevant fields that should be update
## Response
-If successful, this method returns a `204 No Content` response code.
+If successful, this method returns a `204 No Content` response code. Attempting to run this request from an application which you don't own (and without setting the **owner** property to the **appId** of an application you own) returns a `403 Forbidden` response code.
## Example
-##### Request
-
+### Request
+The following is an example of the request. You must include the **owner** property if you're running the request from an application which you don't own. In this case, set the **owner** property to the **appId** of an application you own.
# [HTTP](#tab/http) <!-- {
If successful, this method returns a `204 No Content` response code.
"name": "update_schemaextension" }--> ```http
-PATCH https://graph.microsoft.com/beta/schemaExtensions/{id}
+PATCH https://graph.microsoft.com/beta/schemaExtensions/exto6x7sfft_courses
Content-type: application/json
-Content-length: 201
{
- "properties": [
- {
- "name":"new-name-value",
- "type":"new-type-value"
- },
- {
- "name":"additional-name-value",
- "type":"additional-type-value"
- }
- ]
+ "owner": "ef4cb9a8-97c3-4ca7-854b-5cb5ced376fa",
+ "properties": [
+ {
+ "name": "courseId",
+ "type": "Integer"
+ },
+ {
+ "name": "courseName",
+ "type": "String"
+ },
+ {
+ "name": "courseType",
+ "type": "String"
+ },
+ {
+ "name": "courseSupervisors",
+ "type": "String"
+ }
+ ]
} ``` # [C#](#tab/csharp)
Content-length: 201
-##### Response
+### Response
<!-- { "blockType": "response"
v1.0 Site Search https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/site-search.md
If successful, this method returns a `200 OK` response code and the collection o
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_permission"
If successful, this method returns a `200 OK` response code and the collection o
``` http GET https://graph.microsoft.com/beta/sites?search={query} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list.md
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_wa_count" }--> ```msgraph-interactive
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_to_count" }--> ```msgraph-interactive
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_user_assignedLicenses" } --> ```msgraph-interactive
v1.0 Accesspackageassignmentrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accesspackageassignmentrequest.md
In [Azure AD Entitlement Management](entitlementmanagement-root.md), an access p
| [List accessPackageAssignmentRequests](../api/accesspackageassignmentrequest-list.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) collection | Retrieve a list of **accesspackageassignmentrequest** objects. | | [Create accessPackageAssignmentRequest](../api/accesspackageassignmentrequest-post.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Create a new **accessPackageAssignmentRequest**. | | [Get accessPackageAssignmentRequest](../api/accesspackageassignmentrequest-get.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Read properties and relationships of an **accessPackageAssignmentRequest** object. |
+| [Delete accessPackageAssignmentRequest](../api/accesspackageassignmentrequest-delete.md) |None | Delete an **accessPackageAssignmentRequest**. |
|[filterByCurrentUser](../api/accesspackageassignmentrequest-filterbycurrentuser.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Retrieve the list of **accessPackageAssignmentRequest** objects filtered on the signed-in user.| |[cancel](../api/accesspackageassignmentrequest-cancel.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Cancel an **accessPackageAssignmentRequest** object that is in a cancellable state.| | [reprocess](../api/accesspackageassignmentrequest-reprocess.md) | None | Automatically retry a userΓÇÖs request for access to an access package.|
v1.0 Bookingbusiness https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/bookingbusiness.md
Title: "bookingBusiness resource type"
-description: " > **Important:** APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported."
+description: "Represents a business in Microsoft Bookings."
ms.localizationpriority: medium ms.prod: "bookings"
The following is a JSON representation of the resource.
"schedulingPolicy": {"@odata.type": "microsoft.graph.bookingSchedulingPolicy"}, "webSiteUrl": "String" }- ``` ## See also
v1.0 Dynamics Dimension https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/dynamics-dimension.md
Here is a JSON representation of the resource.
```json {- "id": "GUID", "code": "string", "displayName": "string",
v1.0 Educationassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/educationassignment.md
Title: "educationAssignment resource type"
-description: "The **educationAssignment** resource represents a task or unit of work assigned to a student or team member in a class as part of their study. Only teachers or team owners can create assignments. Assignments contain handouts and tasks that the teacher wants the student to work on. Each student assignment has an associated submission that contains any work their teacher asked to be turned in. A teacher can add scores and feedback to the submission turned in by the student."
+description: "Represents a task or unit of work assigned to a student or team member in a class as part of their study."
ms.localizationpriority: medium ms.prod: "education"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The **educationAssignment** resource represents a task or unit of work assigned to a student or team member in a class as part of their study. Only teachers or team owners can create assignments. Assignments contain handouts and tasks that the teacher wants the student to work on. Each student assignment has an associated [submission](educationsubmissionresource.md) that contains any work their teacher asked to be turned in. A teacher can add scores and feedback to the submission turned in by the student.
+Represents a task or unit of work assigned to a student or team member in a class as part of their study.
-When an assignment is created, it is in a Draft state. Students can't see the assignment and submissions won't be created. You can change the status of an assignment by using the [publish](../api/educationassignment-publish.md) action. You can't use a PATCH request to change the assignment status.
+Only teachers or team owners can create **assignments**. **Assignments** contain handouts and tasks that the teacher wants the student to work on. Each student **assignment** has an associated [submission](educationsubmissionresource.md) that contains any work their teacher asked to be turned in. A teacher can add scores and feedback to the **submission** turned in by the student.
-The assignment APIs are exposed in the class namespace.
+When an **assignment** is created, it is in a Draft state. Students can't see the **assignment** and **submissions** won't be created. You can change the status of an **assignment** by using the [publish](../api/educationassignment-publish.md) action. You can't use a PATCH request to change the **assignment** status.
+
+The **assignment** APIs are exposed in the class namespace.
## Methods | Method | Return Type |Description| |:|:--|:-|
-|[List resources](../api/educationassignment-list-resources.md) |[educationAssignmentResource](educationassignmentresource.md) collection| Get an **educationAssignmentResource** object collection.|
-|[List submissions](../api/educationassignment-list-submissions.md) |[educationSubmission](educationsubmission.md) collection| Get an **educationSubmission** object collection.|
-|[List categories](../api/educationassignment-list-categories.md) |[educationCategory](educationcategory.md) collection| Get an **educationCategory** object collection.|
|[Create assignment resource](../api/educationassignment-post-resources.md) |[educationAssignmentResource](educationassignmentresource.md)| Create a new **educationAssignmentResource** by posting to the resources collection.| |[Get assignment](../api/educationassignment-get.md) | [educationAssignment](educationassignment.md) |Read properties and relationships of an **educationAssignment** object.| |[Update](../api/educationassignment-update.md) | [educationAssignment](educationassignment.md) |Update an **educationAssignment** object. | |[Delete](../api/educationassignment-delete.md) | None |Delete an **educationAssignment** object. |
-|[Add categories](../api/educationassignment-post-categories.md) |[educationCategory](educationcategory.md) | Assign an **educationCategory** belonging to the class to this assignment.|
-|[Remove category](../api/educationassignment-remove-category.md) |None| Remove an **educationCategory** belonging to the class from this assignment.|
-|[Attach rubric](../api/educationassignment-put-rubric.md)|None|Attach an existing **educationRubric** to this assignment.|
-|[Remove rubric](../api/educationassignment-delete-rubric.md)|None|Detach the **educationRubric** from this assignment.|
|[Publish](../api/educationassignment-publish.md)|[educationAssignment](educationassignment.md)|Change the state of an **educationAssignment** object from draft to published.|
-|[Set up assignment resources folder](../api/educationassignment-setupresourcesfolder.md)| string| Create a SharePoint folder (under pre-defined location) to upload files as assignment resources|
+|[Set up assignment resources folder](../api/educationassignment-setupresourcesfolder.md)| string| Create a SharePoint folder (under pre-defined location) to upload files as assignment resources.|
+|[List resources](../api/educationassignment-list-resources.md) |[educationAssignmentResource](educationassignmentresource.md) collection| Get an **educationAssignmentResource** object collection.|
+|[List submissions](../api/educationassignment-list-submissions.md) |[educationSubmission](educationsubmission.md) collection| Get an **educationSubmission** object collection.|
+|[List categories](../api/educationassignment-list-categories.md) |[educationCategory](educationcategory.md) collection| Get an **educationCategory** object collection.|
+|[Add categories](../api/educationassignment-post-categories.md) |[educationCategory](educationcategory.md) | Assign an **educationCategory** belonging to the class to this assignment.|
+|[Remove category](../api/educationassignment-remove-category.md) |None| Remove an **educationCategory** belonging to the class from this **assignment**.|
+|[Attach rubric](../api/educationassignment-put-rubric.md)|None|Attach an existing **educationRubric** to this **assignment**.|
+|[Remove rubric](../api/educationassignment-delete-rubric.md)|None|Detach the **educationRubric** from this **assignment**.|
## Properties | Property | Type |Description| |:|:--|:-| |id|String| Read-only.|
-|addedStudentAction|String|Optional field to control the assignment behavior for students who are added after the assignment is published. If not specified, defaults to `none` value. Currently supports only two values: `none` or `assignIfOpen`.|
-|addToCalendarAction| educationAddToCalendarOptions|Optional field to control the assignment behavior for adding assignments to students' and teachers' calendars when the assignment is published. Possible values are: `studentsAndPublisher`, `studentsAndTeamOwners`, `none`. Default value is `none`.|
+|addedStudentAction|String|Optional field to control the **assignment** behavior for students who are added after the **assignment** is published. If not specified, defaults to `none` value. Currently supports only two values: `none` or `assignIfOpen`.|
+|addToCalendarAction| educationAddToCalendarOptions|Optional field to control the **assignment** behavior for adding **assignments** to students' and teachers' calendars when the **assignment** is published. Possible values are: `none`, `studentsAndPublisher`, `studentsAndTeamOwners`, `studentsOnly` and `unknownFutureValue`. Default value is `none`.|
|allowLateSubmissions|Boolean| Identifies whether students can submit after the due date. If this property is not specified during create, it defaults to true. |
-|allowStudentsToAddResourcesToSubmission|Boolean| Identifies whether students can add their own resources to a submission or if they can only modify resources added by the teacher. |
-|assignDateTime|DateTimeOffset|The date when the assignment should become active. If in the future, the assignment is not shown to the student until this date. 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`|
-|assignTo|[educationAssignmentRecipient](educationassignmentrecipient.md)| Which users, or whole class should receive a submission object once the assignment is published. |
-|assignedDateTime|DateTimeOffset|The moment that the assignment was published to students and the assignment shows up on the students timeline. 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`|
-|classId|String| Class which this assignment belongs. |
-|closeDateTime|DateTimeOffset| Date when the assignment will be closed for submissions. This is an optional field that can be null if the assignment does not allowLateSubmissions or when the closeDateTime is the same as the dueDateTime. But if specified, then the closeDateTime must be greater than or equal to the dueDateTime. 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`|
-|createdBy|[identitySet](identityset.md)| Who created the assignment. |
-|createdDateTime|DateTimeOffset|Moment when the assignment 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`|
-|displayName|String|Name of the assignment.|
-|dueDateTime|DateTimeOffset|Date when the students assignment is 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`|
-|grading|[educationAssignmentGradeType](educationassignmentgradetype.md)|How the assignment will be graded. |
-|instructions|[itemBody](itembody.md)| Instructions for the assignment. This along with the display name tell the student what to do. |
-|lastModifiedBy|[identitySet](identityset.md)| Who last modified the assignment. |
-|lastModifiedDateTime|DateTimeOffset|Moment when the assignment 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`|
-|notificationChannelUrl|String|Optional field to specify the URL of the [channel](channel.md) to post the assignment publish notification. If not specified or null, defaults to the `General` channel. This field only applies to assignments where the **assignTo** value is [educationAssignmentClassRecipient](educationassignmentclassrecipient.md). Updating the **notificationChannelUrl** is not allowed after the assignment has been published.|
+|allowStudentsToAddResourcesToSubmission|Boolean| Identifies whether students can add their own resources to a **submission** or if they can only modify resources added by the teacher. |
+|assignDateTime|DateTimeOffset|The date when the **assignment** should become active. If in the future, the **assignment** is not shown to the student until this date. 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`|
+|assignTo|[educationAssignmentRecipient](educationassignmentrecipient.md)| Which users, or whole class should receive a **submission** object once the **assignment** is published. |
+|assignedDateTime|DateTimeOffset|The moment that the **assignment** was published to students and the **assignment** shows up on the students timeline. 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`|
+|classId|String| Class which this **assignment** belongs. |
+|closeDateTime|DateTimeOffset| Date when the **assignment** will be closed for **submissions**. This is an optional field that can be null if the **assignment** does not allowLateSubmissions or when the closeDateTime is the same as the dueDateTime. But if specified, then the closeDateTime must be greater than or equal to the dueDateTime. 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`|
+|createdBy|[identitySet](identityset.md)| Who created the **assignment**. |
+|createdDateTime|DateTimeOffset|Moment when the **assignment** 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`|
+|displayName|String|Name of the **assignment**.|
+|dueDateTime|DateTimeOffset|Date when the students **assignment** is 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`|
+|grading|[educationAssignmentGradeType](educationassignmentgradetype.md)|How the **assignment** will be graded. |
+|instructions|[itemBody](itembody.md)| Instructions for the **assignment**. This along with the display name tell the student what to do. |
+|lastModifiedBy|[identitySet](identityset.md)| Who last modified the **assignment**. |
+|lastModifiedDateTime|DateTimeOffset|Moment when the **assignment** 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`|
+|notificationChannelUrl|String|Optional field to specify the URL of the [channel](channel.md) to post the **assignment** publish notification. If not specified or null, defaults to the `General` channel. This field only applies to **assignments** where the **assignTo** value is [educationAssignmentClassRecipient](educationassignmentclassrecipient.md). Updating the **notificationChannelUrl** is not allowed after the **assignment** has been published.|
|status|string| Status of the **Assignment**. You can not PATCH this value. Possible values are: `draft`, `scheduled`, `published`, `assigned`.|
-|webUrl|string| The deep link URL for the given assignment.|
-|resourcesFolderUrl|string| Folder URL where all the file resources for this assignment are stored.|
+|webUrl|string| The deep link URL for the given **assignment**.|
+|resourcesFolderUrl|string| Folder URL where all the file resources for this **assignment** are stored.|
## Relationships | Relationship | Type |Description| |:|:--|:-|
-|resources|[educationAssignmentResource](educationassignmentresource.md) collection| Learning objects that are associated with this assignment. Only teachers can modify this list. Nullable.|
-|submissions|[educationSubmission](educationsubmission.md) collection| Once published, there is a submission object for each student representing their work and grade. Read-only. Nullable.|
-|categories|[educationCategory](educationcategory.md) collection| When set, enables users to easily find assignments of a given type. Read-only. Nullable.|
-|rubric|[educationRubric](educationrubric.md)|When set, the grading rubric attached to this assignment.|
+|resources|[educationAssignmentResource](educationassignmentresource.md) collection| Learning objects that are associated with this **assignment**. Only teachers can modify this list. Nullable.|
+|submissions|[educationSubmission](educationsubmission.md) collection| Once published, there is a **submission** object for each student representing their work and grade. Read-only. Nullable.|
+|categories|[educationCategory](educationcategory.md) collection| When set, enables users to easily find **assignments** of a given type. Read-only. Nullable.|
+|rubric|[educationRubric](educationrubric.md)|When set, the grading rubric attached to this **assignment**.|
## JSON representation
v1.0 Educationassignmentdefaults https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/educationassignmentdefaults.md
Specifies class-level defaults respected by new assignments created in the class
|Property|Type|Description| |:|:|:| |addedStudentAction|educationAddedStudentAction|Class-level default behavior for handling students who are added after the assignment is published. Possible values are: `none`, `assignIfOpen`.|
-|addToCalendarAction| educationAddToCalendarOptions|Optional field to control adding assignments to students' and teachers' calendars when the assignment is published. Possible values are: `studentsAndPublisher` and `studentsAndTeamOwners`. |
+|addToCalendarAction| educationAddToCalendarOptions|Optional field to control adding assignments to students' and teachers' calendars when the assignment is published. Possible values are: `none`, `studentsAndPublisher`, `studentsAndTeamOwners`, `studentsOnly` and `unknownFutureValue`. Default value is `none`.|
|dueTime|TimeOfDay|Class-level default value for due time field. Default value is `23:59:00`.| |notificationChannelUrl|String|Default Teams channel to which notifications will be sent. Default value is `null`.|
v1.0 Entitlementmanagement Root https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/entitlementmanagement-root.md
The following table lists the methods that you can use to interact with entitlem
| [List accessPackageAssignmentRequests](../api/accesspackageassignmentrequest-list.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) collection | Retrieve a list of **accessPackageAssignmentRequest** objects. | | [Create accessPackageAssignmentRequest](../api/accesspackageassignmentrequest-post.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Create a new **accessPackageAssignmentRequest**. | | [Get accessPackageAssignmentRequest](../api/accesspackageassignmentrequest-get.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Read properties and relationships of an **accessPackageAssignmentRequest** object. |
+| [Delete accessPackageAssignmentRequest](../api/accesspackageassignmentrequest-delete.md) |None | Delete an **accessPackageAssignmentRequest**. |
|[FilterByCurrentUser](../api/accesspackageassignmentrequest-filterbycurrentuser.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Retrieve the list of **accessPackageAssignmentRequest** objects filtered on the signed-in user.| |[cancel](../api/accesspackageassignmentrequest-cancel.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Cancel an **accessPackageAssignmentRequest** object that is in a cancellable state: `accepted`, `pendingApproval`, `pendingNotBefore`, `pendingApprovalEscalated`.| | [List accessPackageAssignments](../api/accesspackageassignment-list.md) | [accessPackageAssignment](accesspackageassignment.md) collection | Retrieve a list of **accessPackageAssignment** objects. |
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/enums.md
Namespace: microsoft.graph
|studentsAndPublisher| |studentsAndTeamOwners| |unknownFutureValue|
+|studentsOnly|
### externalEmailOtpState values
v1.0 Channel Provisionemail https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/channel-provisionemail.md
If successful, this method returns a `200 OK` response code and a [provisionChan
### Request The following is an example of a request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["893075dd-2487-4122-925f-022c42e20265", "19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2"],
The following is an example of a request.
```http POST https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2/provisionEmail ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response The following is an example of a response.
v1.0 Channel Removeemail https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/channel-removeemail.md
If successful, this action returns a `204 No Content` response code.
## Example ### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "sampleKeys": ["893075dd-2487-4122-925f-022c42e20265", "19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2"],
If successful, this action returns a `204 No Content` response code.
```http POST https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2/removeEmail ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 Directory Deleteditems List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directory-deleteditems-list.md
Content-type: application/json
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_deleteditems_count"
Content-type: application/json
GET https://graph.microsoft.com/v1.0/directory/deletedItems/microsoft.graph.group?$count=true&$orderBy=deletedDateTime asc&$select=id,DisplayName,deletedDateTime ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Educationassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/educationassignment-get.md
doc_type: apiPageType
Namespace: microsoft.graph
-Get the properties and relationships of an assignment.
+Get the properties and relationships of an [assignment](../resources/educationassignment.md).
Students can only see assignments assigned to them; teachers and applications with application permissions can see all assignments in a class.
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454
+GET /education/classes/{id}/assignments/{id}
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
If successful, this method returns a `200 OK` response code and an [educationAss
### Request The following is an example of the request. - # [HTTP](#tab/http) <!-- { "blockType": "request",
- "sampleKeys": ["1fdf61ee-c129-4960-9b7c-8df159aa64b0"],
+ "sampleKeys":["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","3c77de7f-539b-49e1-9c96-1274f2f0ee3b"],
"name": "get_educationassignment" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/education/classes/5edb6a5f-fc6b-441b-8952-bcbfc33ef0e5/assignments/1fdf61ee-c129-4960-9b7c-8df159aa64b0
+GET https://graph.microsoft.com/v1.0/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/3c77de7f-539b-49e1-9c96-1274f2f0ee3b
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationassignment-csharp-snippets.md)]
GET https://graph.microsoft.com/v1.0/education/classes/5edb6a5f-fc6b-441b-8952-b
- ### Response The following is an example of the response.
Content-type: application/json
Content-length: 279 {
- "id": "19002",
- "addedStudentAction": "none",
- "allowLateSubmissions": true,
- "allowStudentsToAddResourcesToSubmission": true,
- "assignDateTime": "String (timestamp)",
- "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
- "assignedDateTime": "2014-01-01T00:00:00Z",
- "classId": "11006",
- "createdBy": {
- "user": {
- "displayName": "Shawn Hughes",
- "id": "14012",
- }
- },
- "closeDateTime": "2014-01-11T00:00:00Z",
- "createdDateTime": "2014-01-01T00:00:00Z",
- "displayName": "Mid term exam",
- "dueDateTime": "2014-01-11T00:00:00Z",
- "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!0sGAoOieeE6iSj1WXCV-nYYTuh2luKRDvUVGQBLOmvYpRzc5ARnCRorRht6P3MhU/items/01N74NOEZL7P3VK22SQFDKBZ3PHVPKDVAQ",
- "grading": {
- "@odata.type": "microsoft.graph.educationAssignmentPointsGradeType",
- "maxPoints": 100
- },
- "instructions": {
- "content": "Answer every question correctly",
- "contentType": "Text"
- },
- "lastModifiedBy": {
- "user": {
- "displayName": "Shawn Hughes",
- "id": "14012",
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('f4a941ff-9da6-4707-ba5b-0eae93cad0b4')/assignments/$entity",
+ "classId": "f4a941ff-9da6-4707-ba5b-0eae93cad0b4",
+ "displayName": "07.30 SubmissionsUploadResource Word2",
+ "closeDateTime": null,
+ "dueDateTime": "2021-08-01T06:59:00Z",
+ "assignDateTime": null,
+ "assignedDateTime": "2021-07-30T16:01:32.5518042Z",
+ "allowLateSubmissions": true,
+ "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeU6BLWBcGc_R6UgCKyYyTin/items/016XPCQECCTNQDGB5U4RCZFBXZBV5ZX24X",
+ "createdDateTime": "2021-07-30T16:00:52.1918016Z",
+ "lastModifiedDateTime": "2021-07-30T19:39:09.6384593Z",
+ "allowStudentsToAddResourcesToSubmission": true,
+ "status": "assigned",
+ "notificationChannelUrl": null,
+ "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7b%22subEntityId%22%3a%22%7b%5c%22version%5c%22%3a%5c%221.0%5c%22%2c%5c%22config%5c%22%3a%7b%5c%22classes%5c%22%3a%5b%7b%5c%22id%5c%22%3a%5c%22f4a941ff-9da6-4707-ba5b-0eae93cad0b4%5c%22%2c%5c%22displayName%5c%22%3anull%2c%5c%22assignmentIds%5c%22%3a%5b%5c%223c77de7f-539b-49e1-9c96-1274f2f0ee3b%5c%22%5d%7d%5d%7d%2c%5c%22action%5c%22%3a%5c%22navigate%5c%22%2c%5c%22view%5c%22%3a%5c%22assignment-viewer%5c%22%7d%22%2c%22channelId%22%3anull%7d",
+ "addedStudentAction": "none",
+ "id": "3c77de7f-539b-49e1-9c96-1274f2f0ee3b",
+ "instructions": {
+ "content": "<div style=\"font-family: inherit; font-size: inherit; color: inherit;\">upload a word document</div>",
+ "contentType": "html"
+ },
+ "grading": {
+ "@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
+ "maxPoints": 10
+ },
+ "assignTo": {
+ "@odata.type": "#microsoft.graph.educationAssignmentClassRecipient"
+ },
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
}
- },
- "lastModifiedDateTime": "2014-01-01T00:00:00Z",
- "notificationChannelUrl": null,
- "status": "assigned"
} ```
v1.0 Educationassignment List Categories https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/educationassignment-list-categories.md
Title: "List categories"
-description: "List all the categories associated with this assignment."
+description: "List all the categories associated with an assignment."
ms.localizationpriority: medium ms.prod: "education"
doc_type: apiPageType
Namespace: microsoft.graph
-List all the categories associated with an assignment.
+List all the categories associated with an [assignment](../resources/educationassignment.md).
## 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).
The following is an example of the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "sampleKeys": ["1fdf61ee-c129-4960-9b7c-8df159aa64b0"],
+ "sampleKeys": ["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","9018ae7a-9953-4796-a152-4c54e0910922"],
"name": "get_assignment_categories" }-->
-```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/education/classes/a17025d0-62a8-4450-9e6e-db31d8c8feb8/assignments/1fdf61ee-c129-4960-9b7c-8df159aa64b0/categories
+```http
+GET https://graph.microsoft.com/v1.0/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/9018ae7a-9953-4796-a152-4c54e0910922/categories
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-assignment-categories-csharp-snippets.md)]
Content-type: application/json
Content-length: 873 {
- "@odata.context": "https://graph.microsoft.com/v1.0/education/classes('a17025d0-62a8-4450-9e6e-db31d8c8feb8')/assignments('1fdf61ee-c129-4960-9b7c-8df159aa64b0')/categories",
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('f4a941ff-9da6-4707-ba5b-0eae93cad0b4')/assignments('9018ae7a-9953-4796-a152-4c54e0910922')/categories",
"value": [ {
- "displayName": "Quizzes",
- "id": "9b8f8f88-ddfc-4aad-9fe9-280513fffc74"
+ "displayName": "August Unit 2",
+ "id": "70563636-801f-440a-989e-14d417cc5c05"
} ] }
v1.0 Educationassignment List Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/educationassignment-list-resources.md
Title: "List assignment resources"
-description: "Get all the resources associated with this assignment."
+description: "Get all the resources associated with an assignment."
ms.localizationpriority: medium ms.prod: "education"
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454/resources
+GET /education/classes/{id}/assignments/{id}/resources
```+ ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
If successful, this method returns a `200 OK` response code and a collection of
### Request The following is an example of the request. - # [HTTP](#tab/http) <!-- { "blockType": "request",
- "sampleKeys": ["ad8afb28-c138-4ad7-b7f5-a6986c2655a8"],
+ "sampleKeys": ["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","9018ae7a-9953-4796-a152-4c54e0910922"],
"name": "get_resources_1" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/education/classes/d38ffdea-da93-46ac-90ba-d568c6073075/assignments/ad8afb28-c138-4ad7-b7f5-a6986c2655a8/resources
+GET https://graph.microsoft.com/v1.0/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/9018ae7a-9953-4796-a152-4c54e0910922/resources
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-resources-1-csharp-snippets.md)]
Content-type: application/json
Content-length: 1011 {
- "value": [
- {
- "distributeForStudentWork": false,
- "resource": {
- "@odata.type": "#microsoft.graph.educationLinkResource",
- "displayName": "Microsoft Homepage",
- "createdDateTime": "2017-10-21T07:52:45.5675913Z",
- "createdBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "lastModifiedDateTime": "2017-10-21T07:52:45.5675913Z",
- "lastModifiedBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "link": "https://www.microsoft.com"
- },
- "id": "850f51b7-1df9-4ec0-bd62-64a0214b9cbf"
- },
- {
- "distributeForStudentWork": true,
- "resource": {
- "@odata.type": "#microsoft.graph.educationWordResource",
- "displayName": "Report.docx",
- "createdDateTime": "2017-10-21T07:52:53.9863696Z",
- "createdBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "lastModifiedDateTime": "2017-10-21T07:52:53.9863696Z",
- "lastModifiedBy": {
- "application": null,
- "device": null,
- "user": {
- "id": "63cc91d2-59c7-4732-9594-35b91a26b340",
- "displayName": null
- }
- },
- "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeTZ_iul5AdW9f/items/017NJZI27BCN2QI2H7HJGLIVPXR6SD2DH6"
- },
- "id": "f2387c3b-ec39-4bf2-a399-d7242677f024"
- }
- ]
+ "value": [
+ {
+ "distributeForStudentWork": false,
+ "id": "eec7f642-9d9a-406f-bbae-4b3b2c12e273",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationFileResource",
+ "displayName": "First file uploaded as Education resource by t-cristobalb",
+ "createdDateTime": "2021-07-16T23:41:53.9378423Z",
+ "lastModifiedDateTime": "2021-07-16T23:41:53.9378423Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeU6BLWBcGc_R6UgCKyYyTin/items/016XPCQEA5VVDIMU4BSFG3VBI37MPHZ3OE",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ }
+ }
+ },
+ {
+ "distributeForStudentWork": false,
+ "id": "ceb3a7e7-158e-4164-9f80-104d14884389",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationPowerPointResource",
+ "displayName": "state diagram.pptx",
+ "createdDateTime": "2021-08-27T14:42:04.8778499Z",
+ "lastModifiedDateTime": "2021-08-27T14:42:04.8778499Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeU6BLWBcGc_R6UgCKyYyTin/items/016XPCQEGRJFHRKPSI6RB3XQ6HGTB4L4FV",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ }
+ }
+ }
+ ]
} ```
v1.0 Educationassignment List Submissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/educationassignment-list-submissions.md
doc_type: apiPageType
Namespace: microsoft.graph
-List all the submissions associated with an assignment.
+List all the submissions associated with an [assignment](../resources/educationassignment.md).
A teacher or an application with application permissions can get all the submissions while a student can only get submissions that they are associated with.
One of the following permissions is required to call this API. To learn more, in
```http GET /education/classes/{id}/assignments/{id}/submissions ```+ ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
This method supports the [OData Query Parameters](/graph/query-parameters) to he
## Request body Don't supply a request body for this method.+ ## Response If successful, this method returns a `200 OK` response code and collection of [educationSubmission](../resources/educationsubmission.md) objects in the response body.+ ## Example ### Request The following is an example of the request.
The following is an example of the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
- "sampleKeys": ["ad8afb28-c138-4ad7-b7f5-a6986c2655a8"],
+ "sampleKeys": ["f4a941ff-9da6-4707-ba5b-0eae93cad0b4","3c77de7f-539b-49e1-9c96-1274f2f0ee3b"],
"name": "get_submissions" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/ad8afb28-c138-4ad7-b7f5-a6986c2655a8/submissions
+GET https://graph.microsoft.com/v1.0/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/3c77de7f-539b-49e1-9c96-1274f2f0ee3b/submissions
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-submissions-csharp-snippets.md)]
Content-type: application/json
Content-length: 873 {
- "value": [
- {
- "id": "33223",
- "recipient": {
- "userId": "13015",
- "@Odata.type":"microsoft.graph.educationSubmissionRecipient"
- },
- "releasedBy": {
- "user": {
- "displayName": "Shawn Hughes",
- "id": "14012"
- },
- },
- "releasedDateTime": "2014-01-01T00:00:00Z",
- "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!8-QjN2tsv0WyGnTv7vOvnQkmGHbbeMNLqYKONmHLVnvCVmBYIGpeT456457AdW9f/items/017NJZI25NOB5XZNLABF7646XAMDZTQQ6T",
- "status": "working",
- "submittedBy": {
- "user": {
- "displayName": "Shawn Hughes",
- "id": "14012"
- },
- },
- "submittedDateTime": "2014-01-01T00:00:00Z"
- }
- ]
+ "value": [
+ {
+ "status": "working",
+ "submittedDateTime": null,
+ "unsubmittedDateTime": null,
+ "returnedDateTime": null,
+ "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeUEWrOk89nKRpUEr4ZhNYBc/items/016XPCQEDJCE5LX4OXABF37QSORAK5WKQD",
+ "id": "4af73d2b-6b9c-493f-0688-979087bed39b",
+ "recipient": {
+ "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient",
+ "userId": "80cefd93-8d88-40e2-b5d3-67898383e226"
+ },
+ "submittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "80cefd93-8d88-40e2-b5d3-67898383e226",
+ "displayName": null
+ }
+ },
+ "unsubmittedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ },
+ "returnedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": null,
+ "displayName": null
+ }
+ }
+ }
+ ]
} ```
v1.0 Educationassignmentdefaults Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/educationassignmentdefaults-get.md
Namespace: microsoft.graph
Read the properties and relationships of an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object.
-These are the class-level assignment defaults respected by new assignments created in the class. Callers can continue to specify custom values on each assignment creation if they Don't want the default behaviors.
+These are the class-level assignment defaults respected by new [assignments](../resources/educationassignment.md) created in the class. Callers can continue to specify custom values on each **assignment** creation if they don't want the default behaviors.
## 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
-GET /education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignmentDefaults
+GET /education/classes/{id}/assignmentDefaults
``` ## Optional query parameters
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and an [educationAssignmentDefaults](../resources/educationassignmentdefaults.md) object in the response body.
-## Examples
+## Example
### Request - # [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["72a7baec-c3e9-4213-a850-f62de0adad5f"],
"name": "get_educationassignmentdefaults" } --> ``` http
-GET https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignmentDefaults
+GET https://graph.microsoft.com/v1.0/education/classes/72a7baec-c3e9-4213-a850-f62de0adad5f/assignmentDefaults
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationassignmentdefaults-csharp-snippets.md)]
HTTP/1.1 200 OK
Content-Type: application/json {
- "value": {
- "addedStudentAction": "none",
- "dueTime": "23:59:00",
- "notificationChannelUrl": "https://graph.microsoft.com/beta/teams('acdefc6b-2dc6-4e71-b1e9-6d9810ab1793')/channels('c6f4e171-da1f-4598-a648-05fcec6cd9ba')"
- }
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('72a7baec-c3e9-4213-a850-f62de0adad5f')/assignmentDefaults/$entity",
+ "dueTime": "2021-08-30T23:59:00Z",
+ "notificationChannelUrl": null,
+ "addedStudentAction": "none"
} ```
v1.0 Educationassignmentresource Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/educationassignmentresource-get.md
doc_type: apiPageType
Namespace: microsoft.graph
-Get the properties of a specific resource on an assignment.
+Get the properties of a specific resource on an [assignment](../resources/educationassignment.md).
+ ## 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
-GET /education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454/resources/8b01c1d0-aafc-4f8c-bd73-89faa3df1c1c
+GET /education/classes/{id}/assignments/{id}/resources/{id}
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
The following is an example of the request.
# [HTTP](#tab/http) <!-- { "blockType": "request",
+ "sampleKeys": ["f4a941ff-9da6-4707-ba5b-0eae93cad0b4", "9018ae7a-9953-4796-a152-4c54e0910922", "eec7f642-9d9a-406f-bbae-4b3b2c12e273"],
"name": "get_educationassignmentresource" }--> ```msgraph-interactive
-GET /education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454/resources/8b01c1d0-aafc-4f8c-bd73-89faa3df1c1c
+GET https://graph.microsoft.com/v1.0/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignments/9018ae7a-9953-4796-a152-4c54e0910922/resources/eec7f642-9d9a-406f-bbae-4b3b2c12e273
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationassignmentresource-csharp-snippets.md)]
Content-type: application/json
Content-length: 842 {
- "distributeForStudentWork": true,
- "id": "22002",
- "resource": {
- "createdBy": {
- "user": {
- "displayName": "Shawn Hughes",
- "id": "14012"
- },
- },
- "createdDateTime": "2014-01-01T00:00:00Z",
- "displayName": "Excel workbook 1",
- "lastModifiedBy": {
- "user": {
- "displayName": "Shawn Hughes",
- "id": "14012"
- },
- },
- "lastModifiedDateTime": "2014-01-01T00:00:00Z"
- }
+ "distributeForStudentWork": false,
+ "id": "eec7f642-9d9a-406f-bbae-4b3b2c12e273",
+ "resource": {
+ "@odata.type": "#microsoft.graph.educationFileResource",
+ "displayName": "First file uploaded as Education resource by t-cristobalb",
+ "createdDateTime": "2021-07-16T23:41:53.9378423Z",
+ "lastModifiedDateTime": "2021-07-16T23:41:53.9378423Z",
+ "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!DPA6q59Tw0mtgmyXRUmrQRqBZTesG-lMkl1cBmvvMeU6BLWBcGc_R6UgCKyYyTin/items/016XPCQEA5VVDIMU4BSFG3VBI37MPHZ3OE",
+ "createdBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ },
+ "lastModifiedBy": {
+ "application": null,
+ "device": null,
+ "user": {
+ "id": "f3a5344e-dbde-48b0-be24-b5b62a243836",
+ "displayName": null
+ }
+ }
+ }
} ```
v1.0 Educationassignmentsettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/educationassignmentsettings-get.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignmentSettings
+GET /education/classes/{id}/assignmentSettings
``` ## Optional query parameters
Don't supply a request body for this method.
If successful, this method returns a `200 OK` response code and an [educationAssignmentSettings](../resources/educationassignmentsettings.md) object in the response body.
-## Examples
+## Example
### Request
If successful, this method returns a `200 OK` response code and an [educationAss
} --> ``` http
-GET https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignmentSettings
+GET https://graph.microsoft.com/v1.0/education/classes/f4a941ff-9da6-4707-ba5b-0eae93cad0b4/assignmentsettings
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-educationassignmentsettings-csharp-snippets.md)]
HTTP/1.1 200 OK
Content-Type: application/json {
- "value": {
"submissionAnimationDisabled": false
- }
} ```
v1.0 Group Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-get.md
HTTP/1.1 200 OK
Content-type: application/json {
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups/$entity",
+ "@odata.id": "https://graph.microsoft.com/v2/84841066-274d-4ec0-a5c1-276be684bdd3/directoryObjects/b320ee12-b1cd-4cca-b648-a437be61c5cd/Microsoft.DirectoryServices.Group",
"id": "b320ee12-b1cd-4cca-b648-a437be61c5cd", "deletedDateTime": null, "classification": null,
- "createdDateTime": "2018-12-22T00:51:37Z",
+ "createdDateTime": "2021-09-13T10:07:01Z",
"creationOptions": [], "description": "Self help community for library", "displayName": "Library Assist",
+ "expirationDateTime": "2022-01-11T10:07:01Z",
"groupTypes": [ "Unified" ], "isAssignableToRole": null,
- "mail": "library2@contoso.com",
+ "mail": "library@contoso.com",
"mailEnabled": true, "mailNickname": "library",
+ "membershipRule": null,
+ "membershipRuleProcessingState": null,
+ "onPremisesDomainName": null,
"onPremisesLastSyncDateTime": null,
+ "onPremisesNetBiosName": null,
+ "onPremisesSamAccountName": null,
"onPremisesSecurityIdentifier": null, "onPremisesSyncEnabled": null,
- "preferredDataLocation": "CAN",
+ "preferredDataLocation": "EU",
+ "preferredLanguage": null,
"proxyAddresses": [
- "smtp:library7423@contoso.com",
- "SMTP:library2@contoso.com"
+ "SPO:SPO_0dbffe23-f6fb-4478-adcd-880daf88bb12@SPO_84841066-274d-4ec0-a5c1-276be684bdd3",
+ "SMTP:library@contoso.com"
],
- "renewedDateTime": "2018-12-22T00:51:37Z",
+ "renewedDateTime": "2021-09-13T10:07:01Z",
"resourceBehaviorOptions": [], "resourceProvisioningOptions": [], "securityEnabled": false,
+ "securityIdentifier": "S-1-12-1-1306860066-1319449225-59104187-458188010",
+ "theme": null,
"visibility": "Public", "onPremisesProvisioningErrors": [] }
v1.0 Identityuserflowattribute List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityuserflowattribute-list.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account)|IdentityUserFlow.Read.All, IdentityUserflow.ReadWrite.All|
+|Delegated (work or school account)|IdentityUserFlow.Read.All, IdentityUserFlow.ReadWrite.All|
|Delegated (personal Microsoft account)| Not supported.| |Application|IdentityUserFlow.Read.All, IdentityUserFlow.ReadWrite.All|
v1.0 Schemaextension Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/schemaextension-delete.md
Do not supply a request body for this method.
If successful, this method returns `204 No Content` response code. It does not return anything in the response body. ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
DELETE https://graph.microsoft.com/v1.0/schemaExtensions/{id}
-##### Response
-Here is an example of the response.
+### Response
+The following is an example of the response.
<!-- { "blockType": "response", "truncated": true
v1.0 Schemaextension Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/schemaextension-get.md
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and [schemaExtension](../resources/schemaextension.md) object in the response body. ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of the request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/v1.0/schemaExtensions/graphlearn_test
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Schemaextension List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/schemaextension-list.md
One of the following permissions is required to call this API. To learn more, in
```http GET /schemaExtensions ```
-## Optional query parameters
-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
## Request headers | Name |Description|
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [schemaExtension](../resources/schemaextension.md) objects in the response body. ## Example
-##### Request
+### Request
The following example shows how to look among all the accessible extensions for a specific one by filtering on its unique **id**. # [HTTP](#tab/http)
GET https://graph.microsoft.com/v1.0/schemaExtensions?$filter=id%20eq%20'graphle
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response. Note: The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 274
{ "value": [
v1.0 Schemaextension Post Schemaextensions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/schemaextension-post-schemaextensions.md
If successful, this method returns `201 Created` response code and [schemaExtens
#### Request
-This example shows using a verified domain name, `graphlearn`, and a schema name, `courses`, to form a unique string for the **id** property of the
-schema extension definition. The unique string is based on this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}.
+This example shows using a verified domain name, `graphlearn`, and a schema name, `courses`, to form a unique string for the **id** property of the schema extension definition. The unique string is based on this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}.
# [HTTP](#tab/http) <!-- {
Content-type: application/json
#### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Content-length: 420
#### Request
-This example shows specifying just a schema name, `courses`, in the **id** property in the request, together with the JSON representation of the rest of the
-properties in the [schemaExtension](../resources/schemaextension.md) object. Microsoft Graph will assign and return a unique string value in the response.
+The following example shows specifying just a schema name, `courses`, in the **id** property in the request, together with the JSON representation of the rest of the properties in the [schemaExtension](../resources/schemaextension.md) object. Microsoft Graph will assign and return a unique string value in the response.
# [HTTP](#tab/http)
Content-type: application/json
The response includes a unique string in the **id** property that is based on the schema name provided in the request, together with the rest of the newly created schema definition. The value in **id** in the response is based on the format, ext\{_&#65279;8-random-alphanumeric-chars_\}\_\{_&#65279;schema-name_\}.
-Note: The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Note: The response object shown here might be shortened for readability.
```http HTTP/1.1 201 Created Content-type: application/json
-Content-length: 420
{ "id": "extk9eruy7c_courses",
Content-length: 420
#### Request
-This example shows how to create a schema extension setting the **owner**. In this scenario, the user of the application might not be the owner of the application (for example if you are using Microsoft Graph Explorer). In this case you should set the **owner** property to the **appId** of an application you own, otherwise you won't be authorized to create a schema extension. Set the **owner** property in the request, together with the JSON representation of the rest of the
-properties in the [schemaExtension](../resources/schemaextension.md) object.
+The following example shows how to create a schema extension setting the **owner**. In this scenario, the user of the application might not be the owner of the application (for example if you are using Microsoft Graph Explorer). In this case you should set the **owner** property to the **appId** of an application you own, otherwise you won't be authorized to create a schema extension. Set the **owner** property in the request, together with the JSON representation of the rest of the properties in the [schemaExtension](../resources/schemaextension.md) object.
# [HTTP](#tab/http)
Content-type: application/json
#### Response
-The response includes the **owner** set to the supplied value in the request.
-Note: The response object shown here might be shortened for readability.
+The response includes the **owner** set to the value supplied in the request.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Note: The response object shown here might be shortened for readability.
```http HTTP/1.1 201 Created Content-type: application/json
-Content-length: 420
{ "id": "extk9eruy7c_courses",
v1.0 Schemaextension Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/schemaextension-update.md
In the request body, supply the values for relevant fields that should be update
## Response
-If successful, this method returns a `204 No Content` response code.
+If successful, this method returns a `204 No Content` response code. Attempting to run this request from an application which you don't own (and without setting the **owner** property to the **appId** of an application you own) returns a `403 Forbidden` response code.
## Example
-##### Request
+### Request
-Here is an example of the request.
+The following is an example of the request. You must include the **owner** property if you're running the request from an application which you don't own. In this case, set the **owner** property to the **appId** of an application you own.
# [HTTP](#tab/http) <!-- {
Here is an example of the request.
"name": "update_schemaextension" }--> ```http
-PATCH https://graph.microsoft.com/v1.0/schemaExtensions/{id}
+PATCH https://graph.microsoft.com/v1.0/schemaExtensions/exto6x7sfft_courses
Content-type: application/json
-Content-length: 201
{
- "properties": [
- {
- "name":"new-name-value",
- "type":"new-type-value"
- },
- {
- "name":"additional-name-value",
- "type":"additional-type-value"
- }
- ]
+ "owner": "ef4cb9a8-97c3-4ca7-854b-5cb5ced376fa",
+ "properties": [
+ {
+ "name": "courseId",
+ "type": "Integer"
+ },
+ {
+ "name": "courseName",
+ "type": "String"
+ },
+ {
+ "name": "courseType",
+ "type": "String"
+ },
+ {
+ "name": "courseSupervisors",
+ "type": "String"
+ }
+ ]
} ``` # [C#](#tab/csharp)
Content-length: 201
-##### Response
+### Response
<!-- { "blockType": "response"
v1.0 Site Search https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-search.md
If successful, this method returns a `200 OK` response code and the collection o
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_permission"
If successful, this method returns a `200 OK` response code and the collection o
``` http GET https://graph.microsoft.com/v1.0/sites?search={query} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-list.md
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_wa_count" } --> ```msgraph-interactive
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_to_count" } --> ```msgraph-interactive
v1.0 Educationassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/educationassignment.md
Title: "educationAssignment resource type"
-description: "The **educationAssignment** resource represents a task or unit of work assigned to a student or team member in a class as part of their study."
+description: "Represents a task or unit of work assigned to a student or team member in a class as part of their study."
ms.localizationpriority: medium ms.prod: "education"
doc_type: resourcePageType
Namespace: microsoft.graph
-The **educationAssignment** resource represents a task or unit of work assigned to a student or team member in a class as part of their study.
+Represents a task or unit of work assigned to a student or team member in a class as part of their study.
-Only teachers or team owners can create assignments. Assignments contain handouts and tasks that the teacher wants the student to work on. Each student assignment has an associated [submission](educationsubmissionresource.md) that contains any work their teacher asked to be turned in. A teacher can add scores and feedback to the submission turned in by the student.
+Only teachers or team owners can create **assignments**. **Assignments** contain handouts and tasks that the teacher wants the student to work on. Each student **assignment** has an associated [submission](educationsubmissionresource.md) that contains any work their teacher asked to be turned in. A teacher can add scores and feedback to the **submission** turned in by the student.
-When an assignment is created, it is in a Draft state. Students can't see the assignment and submissions won't be created. You can change the status of an assignment by using the [publish](../api/educationassignment-publish.md) action. You can't use a PATCH request to change the assignment status.
+When an **assignment** is created, it is in a Draft state. Students can't see the **assignment** and **submissions** won't be created. You can change the status of an **assignment** by using the [publish](../api/educationassignment-publish.md) action. You can't use a PATCH request to change the **assignment** status.
The assignment APIs are exposed in the class namespace.
The assignment APIs are exposed in the class namespace.
| Property | Type |Description| |:|:--|:-| |id|String| Read-only.|
-|addedStudentAction|String|Optional field to control the assignment behavior for students who are added after the assignment is published. If not specified, defaults to `none` value. Currently supports only two values: `none` or `assignIfOpen`.|
+|addedStudentAction|String|Optional field to control the **assignment** behavior for students who are added after the **assignment** is published. If not specified, defaults to `none` value. Currently supports only two values: `none` or `assignIfOpen`.|
|allowLateSubmissions|Boolean| Identifies whether students can submit after the due date. If this property isn't specified during create, it defaults to true. |
-|allowStudentsToAddResourcesToSubmission|Boolean| Identifies whether students can add their own resources to a submission or if they can only modify resources added by the teacher. |
-|assignDateTime|DateTimeOffset|The date when the assignment should become active. If in the future, the assignment isn't shown to the student until this date. 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`|
-|assignTo|[educationAssignmentRecipient](educationassignmentrecipient.md)| Which users, or whole class should receive a submission object once the assignment is published. |
-|assignedDateTime|DateTimeOffset|The moment that the assignment was published to students and the assignment shows up on the students timeline. 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`|
-|classId|String| Class which this assignment belongs. |
-|closeDateTime|DateTimeOffset| Date when the assignment will be closed for submissions. This is an optional field that can be null if the assignment does not allowLateSubmissions or when the closeDateTime is the same as the dueDateTime. But if specified, then the closeDateTime must be greater than or equal to the dueDateTime. 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`|
-|createdBy|[identitySet](identityset.md)| Who created the assignment. |
-|createdDateTime|DateTimeOffset|Moment when the assignment 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`|
-|displayName|String|Name of the assignment.|
-|dueDateTime|DateTimeOffset|Date when the students assignment is 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`|
-|grading|[educationAssignmentGradeType](educationassignmentgradetype.md)|How the assignment will be graded. |
+|allowStudentsToAddResourcesToSubmission|Boolean| Identifies whether students can add their own resources to a **submission** or if they can only modify resources added by the teacher. |
+|assignDateTime|DateTimeOffset|The date when the **assignment** should become active. If in the future, the **assignment** isn't shown to the student until this date. 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`|
+|assignTo|[educationAssignmentRecipient](educationassignmentrecipient.md)| Which users, or whole class should receive a **submission** object once the **assignment** is published. |
+|assignedDateTime|DateTimeOffset|The moment that the **assignment** was published to students and the **assignment** shows up on the students timeline. 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`|
+|classId|String| Class which this **assignment** belongs. |
+|closeDateTime|DateTimeOffset| Date when the **assignment** will be closed for **submissions**. This is an optional field that can be null if the **assignment** does not allowLateSubmissions or when the closeDateTime is the same as the dueDateTime. But if specified, then the closeDateTime must be greater than or equal to the dueDateTime. 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`|
+|createdBy|[identitySet](identityset.md)| Who created the **assignment**. |
+|createdDateTime|DateTimeOffset|Moment when the **assignment** 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`|
+|displayName|String|Name of the **assignment**.|
+|dueDateTime|DateTimeOffset|Date when the students **assignment** is 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`|
+|grading|[educationAssignmentGradeType](educationassignmentgradetype.md)|How the **assignment** will be graded. |
|instructions|[itemBody](itembody.md)| Instructions for the assignment. This along with the display name tell the student what to do. |
-|lastModifiedBy|[identitySet](identityset.md)| Who last modified the assignment. |
-|lastModifiedDateTime|DateTimeOffset|Moment when the assignment 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`|
-|notificationChannelUrl|String|Optional field to specify the URL of the [channel](channel.md) to post the assignment publish notification. If not specified or null, defaults to the `General` channel. This field only applies to assignments where the **assignTo** value is [educationAssignmentClassRecipient](educationassignmentclassrecipient.md). Updating the **notificationChannelUrl** isn't allowed after the assignment has been published.|
+|lastModifiedBy|[identitySet](identityset.md)| Who last modified the **assignment**. |
+|lastModifiedDateTime|DateTimeOffset|Moment when the **assignment** 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`|
+|notificationChannelUrl|String|Optional field to specify the URL of the [channel](channel.md) to post the **assignment** publish notification. If not specified or null, defaults to the `General` channel. This field only applies to **assignments** where the **assignTo** value is [educationAssignmentClassRecipient](educationassignmentclassrecipient.md). Updating the **notificationChannelUrl** isn't allowed after the assignment has been published.|
|status|string| Status of the **Assignment**. You can't PATCH this value. Possible values are: `draft`, `scheduled`, `published`, `assigned`.|
-|webUrl|string| The deep link URL for the given assignment.|
-|resourcesFolderUrl|string| Folder URL where all the file resources for this assignment are stored.|
+|webUrl|string| The deep link URL for the given **assignment**.|
+|resourcesFolderUrl|string| Folder URL where all the file resources for this **assignment** are stored.|
## Relationships | Relationship | Type |Description| |:|:--|:-| |resources|[educationAssignmentResource](educationassignmentresource.md) collection| Learning objects that are associated with this assignment. Only teachers can modify this list. Nullable.|
-|submissions|[educationSubmission](educationsubmission.md) collection| Once published, there is a submission object for each student representing their work and grade. Read-only. Nullable.|
-|categories|[educationCategory](educationcategory.md) collection| When set, enables users to easily find assignments of a given type. Read-only. Nullable.|
-|rubric|[educationRubric](educationrubric.md)|When set, the grading rubric attached to this assignment.|
+|submissions|[educationSubmission](educationsubmission.md) collection| Once published, there is a **submission** object for each student representing their work and grade. Read-only. Nullable.|
+|categories|[educationCategory](educationcategory.md) collection| When set, enables users to easily find **assignments** of a given type. Read-only. Nullable.|
+|rubric|[educationRubric](educationrubric.md)|When set, the grading rubric attached to this **assignment**.|
## JSON representation