Discussion

discussion_entry_created

Definition: The event is emitted anytime an end user or a system replies to a discussion topic or thread.

Trigger: Triggered when a user replies to the discussion topic or thread.

Payload Example:

{
  "metadata": {
    "client_ip": "93.184.216.34",
    "context_account_id": "21070000000000079",
    "context_id": "21070000000000565",
    "context_role": "StudentEnrollment",
    "context_sis_source_id": "2017.100.101.101-1",
    "context_type": "Course",
    "event_name": "discussion_entry_created",
    "event_time": "2019-11-01T19:11:03.933Z",
    "hostname": "oxana.instructure.com",
    "http_method": "POST",
    "producer": "canvas",
    "referrer": "https://oxana.instructure.com/courses/2982/discussion_topics/123456",
    "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/452/discussion_topics/123456/entries/62152/replies",
    "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": "21070000000098765",
    "user_login": "oxana@example.com",
    "user_sis_id": "456-T45"
  },
  "body": {
    "created_at": "2019-07-03T23:12:34Z",
    "discussion_entry_id": "2134567",
    "discussion_topic_id": "123456",
    "parent_discussion_entry_id": "62152",
    "text": "<p>test this discussion</p>",
    "user_id": "98765"
  }
}

Event Body Schema

Field Description
created_at The time at which this entry was created.
discussion_entry_id The Canvas id of the newly added entry.
discussion_topic_id The Canvas id of the topic the entry was added to.
parent_discussion_entry_id If this was a reply, the Canvas id of the parent entry.
text The text of the post. NOTE: This field will be truncated to only include the first 8192 characters.
user_id The Canvas id of the user being that created the entry.

discussion_entry_submitted

Definition: The event is emitted anytime a user or system replies to a graded discussion topic.

Trigger: Triggered when a user replies to a graded discussion topic or discussion thread.

Payload Example:

{
  "metadata": {
    "client_ip": "93.184.216.34",
    "context_account_id": "21070000000000079",
    "context_id": "21070000000000565",
    "context_role": "StudentEnrollment",
    "context_sis_source_id": "2017.100.101.101-1",
    "context_type": "Course",
    "event_name": "discussion_entry_submitted",
    "event_time": "2019-11-01T19:11:04.081Z",
    "hostname": "oxana.instructure.com",
    "http_method": "POST",
    "producer": "canvas",
    "referrer": "https://oxana.instructure.com/courses/8720/discussion_topics/189",
    "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": null,
    "url": "https://oxana.instructure.com/api/v1/courses/26612/discussion_topics/189/entries/59/replies",
    "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": "21070000000023481",
    "user_login": "oxana@example.com",
    "user_sis_id": "456-T45"
  },
  "body": {
    "assignment_id": "649",
    "created_at": "2019-07-03T23:12:34Z",
    "discussion_entry_id": "92",
    "discussion_topic_id": "189",
    "parent_discussion_entry_id": "59",
    "submission_id": "567",
    "text": "<p>test this discussion</p>",
    "user_id": "23481"
  }
}

Event Body Schema

Field Description
assignment_id The Canvas id of the assignment if the discussion topic is graded.
created_at The time at which this entry was created.
discussion_entry_id The Canvas id of the newly added entry.
discussion_topic_id The Canvas id of the topic the entry was added to.
parent_discussion_entry_id If this was a reply, the Canvas id of the parent entry.
submission_id The Canvas id of the submission if the discussion topic is graded.
text The text of the post. NOTE: This field will be truncated to only include the first 8192 characters.
user_id The Canvas id of the user being that created the entry.

discussion_topic_created

Definition: The event is emitted anytime an new discussion topic is created by an end user or API request.

Trigger: Triggered when a new discussion topic is created in a course. Also triggered when a new course announcement is created with is_announcement set to TRUE.

Payload Example:

{
  "metadata": {
    "event_name": "discussion_topic_created",
    "event_time": "2019-11-01T19:11:18.208Z",
    "job_id": "1020020528469291",
    "job_tag": "Canvas::Migration::Worker::CourseCopyWorker#perform",
    "producer": "canvas",
    "root_account_id": "21070000000000001",
    "root_account_lti_guid": "VicYj3cu5BIFpoZhDVU4DZumnlBrWi1grgJEzADs.oxana.instructure.com",
    "root_account_uuid": "VicYj3cu5BIFpoZhDVU4DZumnlBrWi1grgJEzADs"
  },
  "body": {
    "assignment_id": "1234010",
    "body": "<h3>Discuss this</h3> What do you think?",
    "context_id": "1234560",
    "context_type": "Course",
    "discussion_topic_id": "120000001234567",
    "is_announcement": false,
    "lock_at": "2019-11-05T13:38:00.218Z",
    "title": "Sample discussion",
    "updated_at": "2019-11-05T13:38:00.218Z",
    "workflow_state": "active"
  }
}

Event Body Schema

Field Description
assignment_id The Canvas id of the topic's associated assignment
body Body of the topic. NOTE: This field will be truncated to only include the first 8192 characters.
context_id The Canvas id of the topic's context.
context_type The type of the topic's context (usually Course or Group)
discussion_topic_id The Canvas id of the new discussion topic.
is_announcement true if this topic was posted as an announcement, false otherwise.
lock_at The lock date (discussion is locked after this date), or null.
title Title of the topic. NOTE: This field will be truncated to only include the first 8192 characters.
updated_at The time at which this topic was last modified in any way
workflow_state The state of the discussion topic (active, deleted, post_delayed, unpublished).

discussion_topic_updated

Definition: The event is emitted anytime a discussion topic or course announcement 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 discussion topic is modified in a course. Also triggered when a course announcement is modified 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",
    "event_name": "discussion_topic_updated",
    "event_time": "2019-11-04T13:57:43.295Z",
    "hostname": "oxana.instructure.com",
    "http_method": "PUT",
    "producer": "canvas",
    "referrer": "https://oxana.instructure.com/courses/565/discussion_topics",
    "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/discussion_topics/66871",
    "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": "1234010",
    "body": "<h3>Discuss this</h3> What do you think?",
    "context_id": "565",
    "context_type": "Course",
    "discussion_topic_id": "21070000000066871",
    "is_announcement": false,
    "lock_at": "2019-11-05T13:38:00.218Z",
    "title": "Sample discussion",
    "updated_at": "2019-11-05T13:38:00.218Z",
    "workflow_state": "active"
  }
}

Event Body Schema

Field Description
assignment_id The local Canvas id of the assignment.
body Body of the topic. NOTE: This field will be truncated to only include the first 8192 characters.
context_id The Canvas id of the topic's context.
context_type The type of context the discussion_topicis used in.
discussion_topic_id The Canvas id of the new discussion topic.
is_announcement true if this topic was posted as an announcement, false otherwise.
lock_at The lock date (discussion is locked after this date), or null.
title Title of the topic. NOTE: This field will be truncated to only include the first 8192 characters.
updated_at The time at which this discussion was last modified in any way.
workflow_state The state of the discussion topic (active, deleted, post_delayed, unpublished).