Use this method as a student to create, update and submit a submission related to an assignment.
Students can only set attachments and submit.
Teachers can use PUT /classes/{class}/assignments/{assignment}/submissions/{submission} to update a submission by id.
643 matches
79 actions
Flat
79 actions
- Activate the classPOSTv1.0.0
- Add a feedback comment to a submissionPOSTv1.0.0
- Add a new collaboratorPOSTv1.0.0
- Add a new video or audio track to the scorePOSTv1.0.0
- Add a score to the collectionPUTv1.0.0
- Add a user to the classPUTv1.0.0
- Archive the assignmentPOSTv1.0.0
- Archive the classPOSTv1.0.0
- Assignment creationPOSTv1.0.0
- Assignments listingGETv1.0.0
- Copy an assignmentPOSTv1.0.0
- Count the organization users using the provided filtersGETv1.0.0
- Create a new classPOSTv1.0.0
- Create a new collectionPOSTv1.0.0
- Create a new couple of LTI 1.x credentialsPOSTv1.0.0
- Create a new invitation to join the organizationPOSTv1.0.0
- Create a new revisionPOSTv1.0.0
- Create a new scorePOSTv1.0.0
- Create a new user accountPOSTv1.0.0
- Create or edit a submissionPUTv1.0.0
- Delete a collaboratorDELETEv1.0.0
- Delete a commentDELETEv1.0.0
- Delete a feedback comment to a submissionDELETEv1.0.0
- Delete a scoreDELETEv1.0.0
- Delete a score from the collectionDELETEv1.0.0
- Delete a submissionDELETEv1.0.0
- Delete the collectionDELETEv1.0.0
- Edit a score's metadataPUTv1.0.0
- Edit a submissionPUTv1.0.0
- Fork a scorePOSTv1.0.0
- Get a collaboratorGETv1.0.0
- Get a public user profileGETv1.0.0
- Get a score revisionGETv1.0.0
- Get a score revision dataGETv1.0.0
- Get a score's metadataGETv1.0.0
- Get a student submissionGETv1.0.0
- Get collection detailsGETv1.0.0
- Get current user profileGETv1.0.0
- Get group informationGETv1.0.0
- Get the details of a single classGETv1.0.0
- Get the history of the submissionGETv1.0.0
- Join a classPOSTv1.0.0
- List commentsGETv1.0.0
- List group's scoresGETv1.0.0
- List group's usersGETv1.0.0
- List liked scoresGETv1.0.0
- List LTI 1.x credentialsGETv1.0.0
- List submissions related to the scoreGETv1.0.0
- List the audio or video tracks linked to a scoreGETv1.0.0
- List the classes available for the current userGETv1.0.0
- List the collaboratorsGETv1.0.0
- List the collectionsGETv1.0.0
- List the feedback comments of a submissionGETv1.0.0
- List the organization invitationsGETv1.0.0
- List the organization usersGETv1.0.0
- List the revisionsGETv1.0.0
- List the scores contained in a collectionGETv1.0.0
- List the students' submissionsGETv1.0.0
- List the submissions for a studentGETv1.0.0
- List user's scoresGETv1.0.0
- Mark the comment as resolvedPUTv1.0.0
- Mark the comment as unresolvedDELETEv1.0.0
- Post a new commentPOSTv1.0.0
- Remove a user from the classDELETEv1.0.0
- Remove an account from FlatDELETEv1.0.0
- Remove an audio or video track linked to the scoreDELETEv1.0.0
- Remove an organization invitationDELETEv1.0.0
- Retrieve the details of an audio or video track linked to a scoreGETv1.0.0
- Revoke LTI 1.x credentialsDELETEv1.0.0
- Unarchive the assignment.DELETEv1.0.0
- Unarchive the classDELETEv1.0.0
- Untrash a collectionPOSTv1.0.0
- Untrash a scorePOSTv1.0.0
- Update a collection's metadataPUTv1.0.0
- Update a feedback comment to a submissionPUTv1.0.0
- Update account informationPUTv1.0.0
- Update an audio or video track linked to a scorePUTv1.0.0
- Update an existing commentPUTv1.0.0
- Update the classPUTv1.0.0
Other/Flat
Create or edit a submission
v1.0.0Input
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
- 74
- 75
- 76
- 77
- 78
- 79
- 80
- 81
- 82
- 83
- 84
{
"type": "object",
"description": "Assignment Submission creation",
"properties": {
"attachments": {
"type": "array",
"items": {
"type": "object",
"description": "Attachment creation for an assignment or stream post.\nThis attachment must contain a `score` or an `url`, all the details of this one will be resolved and returned as `ClassAttachment` once the assignment or stream post is created.\n",
"properties": {
"googleDriveFileId": {
"type": "string",
"description": "The ID of the Google Drive File"
},
"lockScoreTemplate": {
"type": "boolean",
"description": "To be used with a score attached in `sharingMode` `copy` (score used as template). If true, students won't be able to change the original notes of the template."
},
"score": {
"type": "string",
"description": "A unique Flat score identifier. The user creating the assignment must at least have read access to the document. If the user has admin rights, new group permissions will be automatically added for the\nteachers and students of the class.\n"
},
"sharingMode": {
"type": "string",
"description": "The sharing mode of the score for classes post and assignments",
"enum": [
"read",
"write",
"copy",
"performance"
]
},
"type": {
"type": "string",
"description": "The type of the attachment posted",
"enum": [
"flat",
"link",
"googleDrive",
"worksheet"
]
},
"url": {
"type": "string",
"description": "The URL of the attachment."
},
"worksheet": {
"type": "string",
"description": "An unique worksheet identifier"
}
}
}
},
"comments": {
"type": "object",
"properties": {
"total": {
"type": "number",
"description": "The total number of comments added to the submission"
},
"unread": {
"type": "number",
"description": "The number of unread comments for the current user"
}
}
},
"draftGrade": {
"type": "number",
"description": "Optional grade. If unset, no grade was set. This value is only visible by the teacher, and we will be set to `grade` once the teacher returns the submission"
},
"grade": {
"type": "number",
"description": "Optional grade. If unset, no grade was set."
},
"return": {
"type": "boolean",
"description": "If `true`, the submission will be marked as done"
},
"submit": {
"type": "boolean",
"description": "If `true`, the submission will be marked as done"
}
}
}Output
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
- 74
- 75
- 76
- 77
- 78
- 79
- 80
- 81
- 82
- 83
- 84
- 85
- 86
- 87
- 88
- 89
- 90
- 91
- 92
- 93
- 94
- 95
- 96
- 97
- 98
- 99
- 100
- 101
- 102
- 103
- 104
- 105
- 106
- 107
- 108
- 109
- 110
- 111
- 112
- 113
- 114
- 115
- 116
- 117
- 118
- 119
- 120
- 121
- 122
- 123
- 124
- 125
- 126
- 127
- 128
- 129
- 130
- 131
- 132
- 133
- 134
- 135
- 136
- 137
- 138
- 139
- 140
- 141
- 142
- 143
- 144
- 145
- 146
- 147
- 148
- 149
- 150
- 151
- 152
- 153
- 154
- 155
- 156
- 157
- 158
- 159
- 160
- 161
- 162
- 163
- 164
- 165
- 166
- 167
- 168
- 169
- 170
- 171
- 172
- 173
- 174
- 175
- 176
- 177
- 178
- 179
- 180
- 181
- 182
- 183
- 184
- 185
- 186
- 187
- 188
- 189
- 190
- 191
- 192
- 193
- 194
- 195
- 196
- 197
- 198
- 199
- 200
- 201
- 202
- 203
- 204
{
"type": "object",
"description": "Assignment Submission",
"properties": {
"assignment": {
"type": "string",
"description": "Unique identifier of the assignment"
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"description": "Media attachment. The API will automatically resolve the details, oEmbed,\nand media available if possible and return them in this object\n",
"properties": {
"authorName": {
"type": "string",
"description": "The resolved author name of the attachment"
},
"authorUrl": {
"type": "string",
"description": "The resolved author url of the attachment"
},
"description": {
"type": "string",
"description": "The resolved description of the attachment"
},
"googleDriveFileId": {
"type": "string",
"description": "The ID of the Google Drive File"
},
"html": {
"type": "string",
"description": "If the attachment type is `rich` or `video`, the HTML code of the\nmedia to display\n"
},
"htmlHeight": {
"type": "string",
"description": "If the `html` is available, the height of the widget"
},
"htmlWidth": {
"type": "string",
"description": "If the `html` is available, the width of the widget"
},
"iconUrl": {
"type": "string",
"description": "The URL of the icon"
},
"lockScoreTemplate": {
"type": "boolean",
"description": "To be used with a score attached in `sharingMode` `copy` (score used as template). If true, students won't be able to change the original notes of the template."
},
"mimeType": {
"type": "string",
"description": "The mine type of the file"
},
"revision": {
"type": "string",
"description": "An unique revision identifier of a score"
},
"score": {
"type": "string",
"description": "An unique Flat score identifier"
},
"sharingMode": {
"type": "string",
"description": "The sharing mode of the score for classes post and assignments",
"enum": [
"read",
"write",
"copy",
"performance"
]
},
"thumbnailHeight": {
"type": "integer",
"description": "If the `thumbnailUrl` is available, the width of the thumbnail\n"
},
"thumbnailUrl": {
"type": "string",
"description": "If the attachment type is `rich`, `video`, `photo` or `link`, a\ndisplayable thumbnail for this attachment\n"
},
"thumbnailWidth": {
"type": "integer",
"description": "If the `thumbnailUrl` is available, the width of the thumbnail\n"
},
"title": {
"type": "string",
"description": "The resolved title of the attachment"
},
"track": {
"type": "string",
"description": "A unique track identifier"
},
"type": {
"type": "string",
"description": "The type of the assignment resolved:\n* `rich`, `photo`, `video` are attachment types that are automatically resolved from a `link` attachment.\n* A `flat` attachment is a score document where the unique identifier will be specified in the `score` property. Its sharing mode will be provided in the `sharingMode` property.\n",
"enum": [
"rich",
"photo",
"video",
"link",
"flat",
"googleDrive",
"worksheet",
"performance"
]
},
"url": {
"type": "string",
"description": "The url of the attachment"
},
"worksheet": {
"type": "string",
"description": "An unique worksheet identifier"
}
}
}
},
"classroom": {
"type": "string",
"description": "Unique identifier of the classroom where the assignment was posted\n"
},
"creationDate": {
"type": "string",
"description": "The date when the submission was created"
},
"creator": {
"type": "string",
"description": "The User identifier of the student who created the submission"
},
"draftGrade": {
"type": "number",
"description": "Optional grade. If unset, no grade was set. This value is only visible by the teacher, and we will be set to `grade` once the teacher returns the submission"
},
"googleClassroom": {
"type": "object",
"description": "A coursework submission on Google Classroom",
"properties": {
"alternateLink": {
"type": "string",
"description": "Absolute link to this coursework in the Classroom web UI"
},
"id": {
"type": "string",
"description": "Identifier of the coursework submission assigned by Classroom"
},
"state": {
"type": "string",
"description": "State of the submission on Google Classroom"
}
}
},
"grade": {
"type": "number",
"description": "Optional grade. If unset, no grade was set."
},
"id": {
"type": "string",
"description": "Unique identifier of the submission"
},
"maxPoints": {
"type": "number",
"description": "Optional max points for the grade. If set, a corresponding `draftGrade` or `grade` will be set."
},
"microsoftGraph": {
"type": "object",
"description": "A Microsoft Teams submission",
"properties": {
"alternateLink": {
"type": "string",
"description": "Absolute link to this submission in the Microsoft Teams web UI"
},
"id": {
"type": "string",
"description": "Identifier of the submission assigned by Microsoft Teams"
},
"state": {
"type": "string",
"description": "State of the submission"
}
}
},
"returnCreator": {
"type": "string",
"description": "The User unique identifier of the teacher who returned the submission\n"
},
"returnDate": {
"type": "string",
"description": "The date when the teacher returned the work"
},
"state": {
"type": "string",
"description": "State of the submission",
"enum": [
"created",
"turnedIn",
"returned"
]
},
"submissionDate": {
"type": "string",
"description": "The date when the student submitted his work"
}
}
}