Includes helpers for integration with SIS systems.
A SisAssignment object looks like:
// Assignments that have post_to_sis enabled with other objects for convenience
{
// The unique identifier for the assignment.
"id": 4,
// The unique identifier for the course.
"course_id": 6,
// the name of the assignment
"name": "some assignment",
// The time at which this assignment was originally created
"created_at": "2012-07-01T23:59:00-06:00",
// the due date for the assignment. returns null if not present. NOTE: If this
// assignment has assignment overrides, this field will be the due date as it
// applies to the user requesting information from the API.
"due_at": "2012-07-01T23:59:00-06:00",
// (Optional) Time at which this was/will be unlocked.
"unlock_at": "2013-01-01T00:00:00-06:00",
// (Optional) Time at which this was/will be locked.
"lock_at": "2013-02-01T00:00:00-06:00",
// The maximum points possible for the assignment
"points_possible": 12,
// the types of submissions allowed for this assignment list containing one or
// more of the following: 'discussion_topic', 'online_quiz', 'on_paper', 'none',
// 'external_tool', 'online_text_entry', 'online_url', 'online_upload',
// 'media_recording', 'student_annotation'
"submission_types": ["online_text_entry"],
// Third Party integration id for assignment
"integration_id": "12341234",
// (optional, Third Party integration data for assignment)
"integration_data": "other_data",
// If false, the assignment will be omitted from the student's final grade
"include_in_final_grade": true,
// Includes attributes of a assignment_group for convenience. For more details
// see Assignments API.
"assignment_group": null,
// Includes attributes of a section for convenience. For more details see
// Sections API.
"sections": null,
// Includes attributes of a user assignment overrides. For more details see
// Assignments API.
"user_overrides": null
}
An AssignmentGroupAttributes object looks like:
// Some of the attributes of an Assignment Group. See Assignments API for more
// details
{
// the id of the Assignment Group
"id": 1,
// the name of the Assignment Group
"name": "group2",
// the weight of the Assignment Group
"group_weight": 20,
// the sis source id of the Assignment Group
"sis_source_id": "1234",
// the integration data of the Assignment Group
"integration_data": {"5678":"0954"}
}
A SectionAttributes object looks like:
// Some of the attributes of a section. For more details see Sections API.
{
// The unique identifier for the section.
"id": 1,
// The name of the section.
"name": "Section A",
// The sis id of the section.
"sis_id": "s34643",
// Optional: The integration ID of the section.
"integration_id": "3452342345",
// The course to which the section belongs or the course from which the section
// was cross-listed
"origin_course": null,
// Optional: Attributes of the xlist course. Only present when the section has
// been cross-listed. See Courses API for more details
"xlist_course": null,
// Optional: Attributes of the assignment override that apply to the section.
// See Assignment API for more details
"override": null
}
A CourseAttributes object looks like:
// Attributes of a course object. See Courses API for more details
{
// The unique Canvas identifier for the origin course
"id": 7,
// The name of the origin course.
"name": "Section A",
// The sis id of the origin_course.
"sis_id": "c34643",
// The integration ID of the origin_course.
"integration_id": "I-2"
}
A SectionAssignmentOverrideAttributes object looks like:
// Attributes of an assignment override that apply to the section object. See
// Assignments API for more details
{
// The title for the assignment override
"override_title": "some section override",
// the due date for the assignment. returns null if not present. NOTE: If this
// assignment has assignment overrides, this field will be the due date as it
// applies to the user requesting information from the API.
"due_at": "2012-07-01T23:59:00-06:00",
// (Optional) Time at which this was/will be unlocked.
"unlock_at": "2013-01-01T00:00:00-06:00",
// (Optional) Time at which this was/will be locked.
"lock_at": "2013-02-01T00:00:00-06:00"
}
An UserAssignmentOverrideAttributes object looks like:
// Attributes of assignment overrides that apply to users. See Assignments API
// for more details
{
// The unique Canvas identifier for the assignment override
"id": 218,
// The title of the assignment override.
"title": "Override title",
// The time at which this assignment is due
"due_at": "2013-01-01T00:00:00-06:00",
// (Optional) Time at which this was/will be unlocked.
"unlock_at": "2013-01-01T00:00:00-06:00",
// (Optional) Time at which this was/will be locked.
"lock_at": "2013-02-01T00:00:00-06:00",
// Includes attributes of a student for convenience. For more details see Users
// API.
"students": null
}
A StudentAttributes object looks like:
// Attributes of student. See Users API for more details
{
// The unique Canvas identifier for the user
"user_id": 511,
// The SIS ID associated with the user. This field is only included if the user
// came from a SIS import and has permissions to view SIS information.
"sis_user_id": "SHEL93921"
}
Retrieve a list of published assignments flagged as “post_to_sis”. See the Assignments API for more details on assignments. Assignment group and section information are included for convenience.
Each section includes course information for the origin course and the cross-listed course, if applicable. The ‘origin_course` is the course to which the section belongs or the course from which the section was cross-listed. Generally, the `origin_course` should be preferred when performing integration work. The `xlist_course` is provided for consistency and is only present when the section has been cross-listed. See Sections API and Courses Api for me details.
The ‘override` is only provided if the Differentiated Assignments course feature is turned on and the assignment has an override for that section. When there is an override for the assignment the override object’s keys/values can be merged with the top level assignment object to create a view of the assignment object specific to that section. See Assignments api for more information on assignment overrides.
restricts to courses that start before this date (if they have a start date) restricts to courses that end after this date (if they have an end date) information to include.
"student_overrides":: returns individual student override information
Request Parameters:
Parameter
Type
Description
account_id
integer
The ID of the account to query.
course_id
integer
The ID of the course to query.
starts_before
DateTime
When searching on an account,
ends_after
DateTime
When searching on an account,
include
string
Array of additional
Allowed values: student_overrides
PUT /api/sis/courses/:course_id/disable_post_to_sis
