educationAssignment: setUpResourcesFolder
Namespace: microsoft.graph
Create a SharePoint folder to upload files for a given educationAssignment. Only teachers can perform this operation.
The teacher determines the resources to upload in the assignment's folder.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | EduAssignments.ReadBasic, EduAssignments.Read |
Delegated (personal Microsoft account) | Not supported. |
Application | Not supported. |
HTTP request
POST /education/classes/{id}/assignments/{id}/setUpResourcesFolder
Request headers
Header | Value |
---|---|
Authorization | Bearer {token}. Required. |
Request body
In the request body, supply an empty JSON object {}
for this method.
Response
If successful, this method returns a 200 OK
response code and an educationAssignment object in the request body.
If the specified assignment already has a folder, this method returns a 400 Bad request
and an error response.
Example
The following example shows how to call this API.
Request
The following is an example of a request.
POST https://graph.microsoft.com/v1.0/education/classes/955e0bd5-52c2-41ad-b7e8-5b33a18c5e78/assignments/18d17255-3278-49fb-8da7-d095b7f610c4/setUpResourcesFolder
Content-type: application/json
{
}
Response
The following is an example of the response.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('955e0bd5-52c2-41ad-b7e8-5b33a18c5e78')/assignments/$entity",
"classId": "955e0bd5-52c2-41ad-b7e8-5b33a18c5e78",
"displayName": "Unit 3 Essay",
"closeDateTime": "2021-04-06T00:00:00Z",
"dueDateTime": "2021-04-05T00:00:00Z",
"assignDateTime": "2021-04-01T00:00:00Z",
"assignedDateTime": null,
"allowLateSubmissions": true,
"createdDateTime": "2021-03-04T00:02:31.9834674Z",
"lastModifiedDateTime": "2021-03-04T00:02:32.0954032Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "draft",
"notificationChannelUrl": null,
"addedStudentAction": "assignIfOpen",
"addToCalendarAction": "studentsAndTeamOwners",
"id": "18d17255-3278-49fb-8da7-d095b7f610c4",
"instructions": {
"content": "Upload a 500 word essay about the theme of nature in a Shakespearean sonnet.",
"contentType": "text"
},
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 100
},
"assignTo": {
"@odata.type": "#microsoft.graph.educationAssignmentIndividualRecipient",
"recipients": [
"42ff222c-571f-497c-a9d3-f77ea9ece327"
]
},
"resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!H0Unq6KJREmMLHgbJXfKw4YTuh2luKRDvUVGQBLOmvaRxxvbedZKT4LKslSIjT9a/items/01SMYGQ3IUCDNLBJ4XCFE3AQMQHTLSLVYX",
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "42ff222c-571f-497c-a9d3-f77ea9ece327",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "42ff222c-571f-497c-a9d3-f77ea9ece327",
"displayName": null
}
}
}
If the specified assignment already has a folder, this method returns a 400 Bad request
and an error response.
HTTP/1.1 400 Bad request
Content-type: application/json
{
"error": {
"code": "badRequest",
"message": "Bad request.",
"innerError": {
"code": "folderAlreadyExists",
"message": "Resource folder already exists and has previously been set up.",
"date": "2021-09-14T19:05:24",
"request-id": "f88be238-1339-49c8-b03d-37f45d54761f",
"client-request-id": "30d8081a-f3e8-73e0-2da4-3480fb56ccdb"
}
}
}
Feedback
Submit and view feedback for