Definition: The event is emitted anytime a new assignment is created by an end user or API request.
Trigger: Triggered when a new assignment is created in a course.
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","developer_key_id":"170000000056","event_name":"assignment_created","event_time":"2019-11-01T19:11:11.323Z","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","time_zone":"America/Los_Angeles","url":"https://oxana.instructure.com/api/v1/courses/565/assignments","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_group_id":"210700000000101907","assignment_id":"21070000000000371","context_id":"21070000000000565","context_type":"Course","context_uuid":"a1b2c3c4z9x8a1s2q5w6p9o8i7u6y5t6a2s3d4f5","created_on_blueprint_sync":false,"description":"<p>test assignment</p>","due_at":"2018-10-01T05:59:59Z","lock_at":"2018-10-01T05:59:59Z","lti_assignment_id":"8b81d12c-fda4-4317-8d83-e987a6d2014a","lti_resource_link_id":"a1b2c3c4z9x8a1s2q5w6p9o8i7u6y5t6a2s3d8h9","lti_resource_link_id_duplicated_from":"a1b2c3c4z9x8a1s2q5w6p9o8i7u6y5t6a2s3d8h9","assignment_id_duplicated_from":"21070000000000420","domain_duplicated_from":"oxana.instructure.com","domain":"oxana.instructure.com","points_possible":100,"submission_types":"online_url,online_upload","title":"add_new_assignment_3","unlock_at":"2018-09-24T06:00:00Z","updated_at":"2018-10-03T14:50:31Z","workflow_state":"created" }}
Event Body Schema
Field
Description
assignment_group_id
The Canvas id of the assignment group.
assignment_id
The Canvas id of the new assignment.
context_id
The type of context the assignment is used in.
context_type
The type of context the assignment is used in.
context_uuid
The uuid of the context associated with the assignment.
created_on_blueprint_sync
Whether or not the assignment was created in the context of a blueprint sync.
description
The description of the assignment. NOTE: This field will be truncated to only include the first 8192 characters.
due_at
The due date for the assignment.
lock_at
The lock date (assignment is locked after this date).
lti_assignment_id
The LTI assignment guid for the assignment.
lti_resource_link_id
The unique identifier of the assignment resource in the LTI specification. Unique per Canvas shard.
lti_resource_link_id_duplicated_from
The LTI resource link ID of the original assignment. Present if new assigment is a copy.
assignment_id_duplicated__from
The Canvas id of the original assignment. Present if new assigment is a copy.
domain_duplicated_from
The Canvas domain of the root account of the original assignment. Present if new assigment is a copy.
domain
The Canvas domain of the root account of the assignment.
points_possible
The maximum points possible for the assignment.
submission_types
Valid methods for submitting the assignment, may include multiple comma separated options of: discussion_topic, external_tool, media_recording, none, not_graded, online_quiz, online_text_entry, online_upload, online_url, on_paper.
title
The title of the assignment. NOTE: This field will be truncated to only include the first 8192 characters.
unlock_at
The unlock date (assignment is unlocked after this date).
updated_at
The time at which this assignment was last modified in any way.
workflow_state
Workflow state of the assignment. E.g duplicating, fail_to_import, failed_to_duplicate, published, unpublished. See API documentation for more details.
assignment_group_created
Definition: The event is emitted anytime a new assignment group is created by an end user or API request.
Trigger: Triggered when a new assignment group is created in a course.
Payload Example:
{"metadata": {"client_ip":"93.184.216.34","context_account_id":"21070000000000079","context_id":"21070000000000565","context_sis_source_id":"2017.100.101.101-1","context_type":"Course","developer_key_id":"170000000056","event_name":"assignment_group_created","event_time":"2019-11-01T19:11:42.910Z","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","time_zone":"America/Denver","url":"https://oxana.instructure.com/api/v1/courses/565/assignment_groups","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_group_id":"642","context_id":"565","context_type":"Course","group_weight":0,"integration_data":null,"name":"test_assignment_group","position":10,"rules":"drop_lowest:1\\n","sis_source_id":"SIS_ID_234","workflow_state":"available" }}
Event Body Schema
Field
Description
assignment_group_id
The Canvas id of the new assignment group.
context_id
The Canvas context id of the new assignment group.
context_type
The context type of the new assignment group.
group_weight
The group weight of the new assignment group.
integration_data
Integration data for the new assignment group.
name
The name of the new assignment group.
position
The position of the new assignment group on the assignments page.
rules
Rules for the new assignment group.
sis_source_id
The SIS source id of the new assignment group.
workflow_state
Workflow state of the assignment group.
assignment_group_updated
Definition: The event is emitted anytime an assignment group is updated by an end user or API request. Only changes to the fields included in the body of the event payload will emit the updated event.
Trigger: Triggered when a user or asynchronous job updates a new assignment group in a course context.
Payload Example:
{"metadata": {"client_ip":"93.184.216.34","context_account_id":"21070000000000079","context_id":"21070000000000565","context_role":"Training Teacher","context_sis_source_id":"2017.100.101.101-1","context_type":"Course","event_name":"assignment_group_updated","event_time":"2019-11-01T00:09:05.961Z","hostname":"oxana.instructure.com","http_method":"PUT","producer":"canvas","referrer":"https://oxana.instructure.com/courses/565/assignments","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/Mexico_City","url":"https://oxana.instructure.com/api/v1/courses/565/assignment_groups/642","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_group_id":"642","context_id":"565","context_type":"Course","group_weight":0,"integration_data":null,"name":"test_assignment_group1","position":10,"rules":"never_drop:123","sis_source_id":"SIS_ID123","workflow_state":"available" }}
Event Body Schema
Field
Description
assignment_group_id
The Canvas id of the updated assignment group.
context_id
The Canvas context id of the updated assignment group.
context_type
The context type of the updated assignment group.
group_weight
The group weight of the updated assignment group.
integration_data
Integration data for the updated assignment group.
name
The name of the updated assignment group.
position
The position of the updated assignment group.
rules
Rules for the updated assignment group.
sis_source_id
The SIS source id of the updated assignment group.
workflow_state
Workflow state of the assignment group.
assignment_override_created
Definition: The event is emitted anytime an assignment override is created by an end user or API request.
Trigger: Triggered when an assignment override is created.
Payload Example:
{"metadata": {"client_ip":"93.184.216.34","context_account_id":"21070000000000079","context_id":"21070000001279362","context_role":"TeacherEnrollment","context_sis_source_id":"2017.100.101.101-1","context_type":"Course","developer_key_id":"170000000056","event_name":"assignment_override_created","event_time":"2019-11-01T19:11:14.005Z","hostname":"oxana.instructure.com","http_method":"PUT","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","time_zone":"America/New_York","url":"https://oxana.instructure.com/api/v1/courses/1279362/assignments/2030605","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_override_id":1,"assignment_id":1,"due_at":"2019-08-10T12:35:54Z","all_day":true,"all_day_date":"2019-08-10T00:00:00Z","unlock_at":"2019-08-01T00:00:00Z","lock_at":"2019-08-21T00:00:00Z","type":"CourseSection","course_section_id":1,"workflow_state":"active" }}
Event Body Schema
Field
Description
assignment_override_id
The Canvas id of the assignment override.
assignment_id
The Canvas id of the assignment linked to the override.
due_at
The override due_at timestamp, or nil if not overridden.
all_day
The overridden all_day flag, or nil if not overridden.
all_day_date
The overridden all_day_date, or nil if not overridden.
unlock_at
The overridden unlock_at timestamp, or nil if not overridden.
lock_at
The overridden lock_at timestamp, or nil if not overridden.
type
Override type - ADHOC (list of Students), CourseSection, or Group.
course_section_id
(if type='CourseSection') Canvas section id that this override applies to.
group_id
(if type='Group') Canvas group id that this override applies to.
workflow_state
Workflow state of the override. (active, deleted)
assignment_override_updated
Definition: The event is emitted anytime an assignment override is updated by an end user or API request. Only changes to the fields included in the body of the event payload will emit the updated event.
Trigger: Triggered when an assignment override has been modified.
Payload Example:
{"metadata": {"client_ip":"93.184.216.34","context_account_id":"21070000000000079","context_id":"21070000001279362","context_role":"TeacherEnrollment","context_sis_source_id":"2017.100.101.101-1","context_type":"Course","developer_key_id":"170000000056","event_name":"assignment_override_updated","event_time":"2019-11-01T19:11:14.005Z","hostname":"oxana.instructure.com","http_method":"PUT","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","time_zone":"America/New_York","url":"https://oxana.instructure.com/api/v1/courses/1279362/assignments/2030605","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_override_id":1,"assignment_id":1,"due_at":"2019-08-10T12:35:54Z","all_day":true,"all_day_date":"2019-08-10T00:00:00Z","unlock_at":"2019-08-01T00:00:00Z","lock_at":"2019-08-21T00:00:00Z","type":"CourseSection","course_section_id":1,"workflow_state":"active" }}
Event Body Schema
Field
Description
assignment_override_id
The Canvas id of the assignment override.
assignment_id
The Canvas id of the assignment linked to the override.
due_at
The override due_at timestamp, or nil if not overridden.
all_day
The overridden all_day flag, or nil if not overridden.
all_day_date
The overridden all_day_date, or nil if not overridden.
unlock_at
The overridden unlock_at timestamp, or nil if not overridden.
lock_at
The overridden lock_at timestamp, or nil if not overridden.
type
Override type - ADHOC (list of Students), CourseSection, or Group.
course_section_id
(if type='CourseSection') Canvas section id that this override applies to.
group_id
(if type='Group') Canvas group id that this override applies to.
workflow_state
Workflow state of the override. (active, deleted)
assignment_updated
Definition: The event is emitted anytime an assignment is updated by an end user or API request. Only changes to the fields included in the body of the event payload will emit the updated event.
Trigger: Triggered when an assignment has been modified.
Payload Example:
{"metadata": {"client_ip":"93.184.216.34","context_account_id":"21070000000000079","context_id":"21070000001279362","context_role":"TeacherEnrollment","context_sis_source_id":"2017.100.101.101-1","context_type":"Course","developer_key_id":"170000000056","event_name":"assignment_updated","event_time":"2019-11-01T19:11:14.005Z","hostname":"oxana.instructure.com","http_method":"PUT","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","time_zone":"America/New_York","url":"https://oxana.instructure.com/api/v1/courses/1279362/assignments/2030605","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_group_id":"21070000001234567","assignment_id":"21070000002030605","context_id":"21070000001279362","context_type":"Course","context_uuid":"a1b2c3c4z9x8a1s2q5w6p9o8i7u6y5t6a2s3d4f5","created_on_blueprint_sync":false,"description":"<h3>Assignment Description<h3/> This is your tasks, students:...","due_at":"2019-11-05T13:38:00.218Z","lock_at":"2019-11-05T13:38:00.218Z","lti_assignment_id":"a1b2c3c4-z9x8-a1s2-q5w6-p9o8i7u6y5t6","lti_resource_link_id":"a1b2c3c4z9x8a1s2q5w6p9o8i7u6y5t6a2s3d4f5","lti_resource_link_id_duplicated_from":"a1b2c3c4z9x8a1s2q5w6p9o8i7u6y5t6a2s3d4f5","assignment_id_duplicated__from":"21070000000000420","domain_duplicated_from":"oxana.instructure.com","domain":"oxana.instructure.com","points_possible":100,"submission_types":"discussion_topic, external_tool, media_recording, none, not_graded, on_paper, online_quiz, online_text_entry, online_upload, online_url, wiki_page","title":"A New Assignment For Today","unlock_at":"2019-11-05T13:38:00.218Z","updated_at":"2019-11-05T13:38:00.218Z","workflow_state":"published" }}
Event Body Schema
Field
Description
assignment_group_id
The Canvas id of the assignment group.
assignment_id
The Canvas id of the new assignment.
context_id
The Canvas id for the context the assignment is used in.
context_type
The type of context the assignment is used in (usually Course).
context_uuid
The uuid of the context associated with the assignment.
created_on_blueprint_sync
Whether or not the assignment was created in the context of a blueprint sync.
description
The description of the assignment. NOTE: This field will be truncated to only include the first 8192 characters.
due_at
The due date for the assignment.
lock_at
The lock date (assignment is locked after this date).
lti_assignment_id
The LTI assignment guid for the assignment.
lti_resource_link_id
The unique identifier of the assignment resource in the LTI specification. Unique per Canvas shard.
lti_resource_link_id_duplicated_from
The LTI resource link ID of the original assignment. Present if new assigment is a copy.
assignment_id_duplicated__from
The Canvas id of the original assignment. Present if new assigment is a copy.
domain_duplicated_from
The Canvas domain of the root account of the original assignment. Present if new assigment is a copy.
domain
The Canvas domain of the root account of the assignment.
points_possible
The maximum points possible for the assignment.
submission_types
Valid methods for submitting the assignment, may include multiple comma separated options.
title
The title of the assignment. NOTE: This field will be truncated to only include the first 8192 characters.
unlock_at
The unlock date (assignment is unlocked after this date), or null if not applicable.
updated_at
The time at which this assignment was last modified in any way.
workflow_state
Workflow state of the assignment (deleted, duplicating, fail_to_import, failed_to_duplicate, failed_to_migrate, importing, published, unpublished).
This documentation is generated directly from the Canvas LMS source code, available on Github.
