Submission
submission_comment_created
Definition: The event is emitted anytime an end user or API request comments on a submission.
Trigger: Triggered when a new comment is added to a submission.
Payload Example:
{
"metadata": {
"client_ip": "93.184.216.34",
"context_account_id": "21070000000000079",
"context_id": "21070000000000565",
"context_role": "TeacherEnrollment",
"context_sis_source_id": "2017.100.101.101-1",
"context_type": "Course",
"event_name": "submission_comment_created",
"event_time": "2019-11-01T19:11:13.216Z",
"hostname": "oxana.instructure.com",
"http_method": "POST",
"producer": "canvas",
"referrer": "https://oxana.instructure.com/courses/565/gradebook/speed_grader?assignment_id=2974715&student_id=1740548",
"request_id": "1dd9dc6f-2fb0-4c19-a6c5-7ee1bf3ed295",
"root_account_id": "21070000000000001",
"root_account_lti_guid": "VicYj3cu5BIFpoZhDVU4DZumnlBrWi1grgJEzADs.oxana.instructure.com",
"root_account_uuid": "VicYj3cu5BIFpoZhDVU4DZumnlBrWi1grgJEzADs",
"session_id": "ef686f8ed684abf78cbfa1f6a58112b5",
"time_zone": "America/Los_Angeles",
"url": "https://oxana.instructure.com/courses/410200/assignments/3964323/submissions/986036.text",
"user_account_id": "21070000000000001",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.103 Safari/537.36",
"user_id": "21070000000012345",
"user_login": "oxana@example.com",
"user_sis_id": "456-T45"
},
"body": {
"attachment_ids": [
"54417187",
"54417188"
],
"body": "See the attached files",
"created_at": "2019-11-01T19:11:13.216Z",
"submission_comment_id": "19811981",
"submission_id": "9987654",
"user_id": "12345"
}
}
Event Body Schema
Field | Description |
---|---|
attachment_ids | Array of Canvas ids (as strings) of attachments for this comment. |
body | The text of the comment. NOTE: This field will be truncated to only include the first 8192 characters. |
created_at | The timestamp when the comment was created. |
submission_comment_id | The Canvas id of the new comment. |
submission_id | The Canvas id of the new submission. |
user_id | The Canvas id of the user who authored the comment. |
submission_created
Definition: The event is emitted anytime an end user or API request submits or re-submits an assignment. This applies to assignments and new quizzes, not classic quizzes. Use quiz_submitted for classic quiz submissions.
Trigger: Triggered when an assignment or new quizzes submission gets updated and has not yet been submitted.
Payload Example:
{
"metadata": {
"client_ip": "93.184.216.34",
"event_name": "submission_created",
"event_time": "2019-11-01T19:11:21.419Z",
"hostname": "oxana.instructure.com",
"http_method": "POST",
"producer": "canvas",
"referrer": null,
"request_id": "1dd9dc6f-2fb0-4c19-a6c5-7ee1bf3ed295",
"root_account_id": "21070000000000001",
"root_account_lti_guid": "VicYj3cu5BIFpoZhDVU4DZumnlBrWi1grgJEzADs.oxana.instructure.com",
"root_account_uuid": "VicYj3cu5BIFpoZhDVU4DZumnlBrWi1grgJEzADs",
"session_id": "ef686f8ed684abf78cbfa1f6a58112b5",
"url": "https://oxana.instructure.com/api/lti/v1/tools/453919/grade_passback",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.103 Safari/537.36"
},
"body": {
"assignment_id": "21070000001234012",
"attempt": 12,
"body": "Test Submission Data",
"grade": "Missing",
"graded_at": "2019-11-01T19:11:21.419Z",
"group_id": "120123",
"late": false,
"lti_assignment_id": "a1b2c3c4-z9x8-a1s2-q5w6-p9o8i7u6y5t6",
"lti_user_id": "a1b2c3c4z9x8a1s2q5w6p9o8i7u6y5t6a2s3d4f5",
"missing": false,
"score": 99.5,
"submission_id": "21070000012345567",
"submission_type": "online_text_entry",
"submitted_at": "2019-11-01T19:11:21.419Z",
"updated_at": "2019-11-01T19:11:21.419Z",
"url": "https://test.submission.net",
"user_id": "21070000000014012",
"workflow_state": "submitted"
}
}
Event Body Schema
Field | Description |
---|---|
assignment_id | The Canvas id of the assignment being submitted. |
attempt | This is the submission attempt number. |
body | The content of the submission, if it was submitted directly in a text field. NOTE: This field will be truncated to only include the first 8192 characters. |
grade | The grade for the submission, translated into the assignment grading scheme (so a letter grade, for example) |
graded_at | The timestamp when the assignment was graded, if it was graded. |
group_id | The submissions’s group ID if the assignment is a group assignment. |
late | Whether the submission was made after the applicable due date. |
lti_assignment_id | The LTI assignment guid of the submission's assignment |
lti_user_id | The Lti id of the user associated with the submission. |
missing | Whether the submission is missing, which generally means past-due and not yet submitted. |
score | The raw score |
submission_id | The Canvas id of the new submission. |
submission_type | The types of submission (basic_lti_launch, discussion_topic, media_recording, online_quiz, online_text_entry, online_upload, online_url) |
submitted_at | The timestamp when the assignment was submitted. |
workflow_state | The state of the submission: normally 'submitted' or 'pending_review'. |
updated_at | The time at which this assignment was last modified in any way |
url | The URL of the submission (for 'online_url' submissions) |
user_id | The Canvas id of the user associated with the submission. |
submission_updated
Definition: The event is emitted anytime an end user or API request modifies a submitted assignment or when a Teacher grades an assignment.
Trigger: Triggered when a submission gets updated.
Payload Example:
{
"metadata": {
"client_ip": "93.184.216.34",
"context_account_id": "21070000000000079",
"context_id": "21070000000000565",
"context_role": "TeacherEnrollment",
"context_sis_source_id": "2017.100.101.101-1",
"context_type": "Course",
"event_name": "submission_updated",
"event_time": "2019-11-01T19:11:11.325Z",
"hostname": "oxana.instructure.com",
"http_method": "POST",
"producer": "canvas",
"referrer": "https://oxana.instructure.com/courses/1465707/gradebook/speed_grader?assignment_id=21868751&student_id=8026013",
"request_id": "1dd9dc6f-2fb0-4c19-a6c5-7ee1bf3ed295",
"root_account_id": "21070000000000001",
"root_account_lti_guid": "VicYj3cu5BIFpoZhDVU4DZumnlBrWi1grgJEzADs.oxana.instructure.com",
"root_account_uuid": "VicYj3cu5BIFpoZhDVU4DZumnlBrWi1grgJEzADs",
"session_id": "ef686f8ed684abf78cbfa1f6a58112b5",
"time_zone": "America/Los_Angeles",
"url": "https://oxana.instructure.com/courses/2176632/gradebook/update_submission",
"user_account_id": "21070000000000001",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.103 Safari/537.36",
"user_id": "21070000000000001",
"user_login": "oxana@example.com",
"user_sis_id": "456-T45"
},
"body": {
"assignment_id": "21070000000000396",
"attempt": 1,
"body": "user: 47, quiz: 78, score: 0.0, time: 2018-10-09 21:29:57 +0000",
"grade": "S",
"graded_at": "2018-10-09T21:29:57Z",
"group_id": "120120",
"late": false,
"lti_assignment_id": "f7d76a11-95be-485b-8827-dbe8fdca3332",
"lti_user_id": null,
"missing": false,
"score": 99.5,
"submission_id": "21070000000011176",
"submission_type": "online_quiz",
"submitted_at": "2018-10-09T21:29:57Z",
"updated_at": "2018-10-09T21:29:57Z",
"url": null,
"user_id": "21070000000000047",
"workflow_state": "submitted"
}
}
Event Body Schema
Field | Description |
---|---|
assignment_id | The Canvas id of the assignment being submitted. |
attempt | This is the submission attempt number. |
body | The content of the submission, if it was submitted directly in a text field. NOTE: This field will be truncated to only include the first 8192 characters. |
grade | The grade for the submission, translated into the assignment grading scheme (so a letter grade, for example) |
graded_at | The timestamp when the assignment was graded, if it was graded. |
group_id | The submissions’s group ID if the assignment is a group assignment. |
late | Whether the submission was made after the applicable due date. |
lti_assignment_id | The LTI assignment guid of the submission's assignment |
lti_user_id | The Lti id of the user associated with the submission. |
missing | Whether the submission is missing, which generally means past-due and not yet submitted. |
score | The raw score |
submission_id | The Canvas id of the new submission. |
submission_type | The types of submission (online_text_entry, online_url, online_upload, media_recording) |
submitted_at | The timestamp when the assignment was submitted. |
workflow_state | The state of the submission, such as 'submitted' or 'graded'. |
updated_at | The time at which this assignment was last modified in any way |
url | The URL of the submission (for 'online_url' submissions) |
user_id | The Canvas id of the user associated with the submission. |