Canvas
canvasCanvas is a learning management system supporting online courses, assignments, grading, and collaboration, widely used by schools and universities for virtual classrooms
Acciones disponibles (87)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Create account notificationCANVAS_CREATE_ACCOUNT_NOTIFICATIONAcciónCreates a global notification within a canvas account, ensuring `end at` is after `start at` and any specified `notification roles` are valid.
CANVAS_CREATE_ACCOUNT_NOTIFICATIONAcciónCreates a global notification within a canvas account, ensuring `end at` is after `start at` and any specified `notification roles` are valid.
Parámetros de entrada
iconstringenumIcon to display with the notification.
warninginformationquestionerrorcalendarend_atstringObligatorioEnd date/time for visibility (ISO8601 format); must be after `start_at`.
messagestringObligatorioMain content/body of the notification.
subjectstringObligatorioSubject line of the notification.
start_atstringObligatorioStart date/time for visibility (ISO8601 format).
account_idstringObligatorioCanvas account ID for the notification.
notification_rolesstring[]Optional list of specific user role(s) to receive the notification (e.g., 'StudentEnrollment', 'TeacherEnrollment'); roles must be valid for the account. If omitted, Canvas defaults to broader visibility.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create appointment groupCANVAS_CREATE_APPOINTMENT_GROUPAcciónCreates a new appointment group in canvas for schedulable time slots within specified course or group contexts.
CANVAS_CREATE_APPOINTMENT_GROUPAcciónCreates a new appointment group in canvas for schedulable time slots within specified course or group contexts.
Parámetros de entrada
titlestringObligatorioTitle for the appointment group (e.g., 'Office Hours').
publishbooleanIf `True`, publishes the appointment group making it visible for sign-ups.
descriptionstringLonger description or instructions for participants.
context_codesstring[]ObligatorioContext codes (e.g., 'course_123') to link this appointment group; at least one is required.
location_namestringName of the location (e.g., 'Room 301', 'Online via Zoom').
location_addressstringAddress for the location (e.g., physical address or meeting URL).
sub_context_codesstring[]Sub-context codes (e.g., 'section_789') to further restrict the group within primary `context_codes`.
allow_observer_signupbooleanIf `True`, allows users with an observer role (e.g., parents, mentors) to sign up.
participant_visibilitystringenumControls sign-up visibility: 'private' (organizers only see sign-ups) or 'protected' (participants see others in the same slot).
privateprotectedparticipants_per_appointmentintegerMaximum participants per time slot. If unspecified, Canvas may apply a default or allow unlimited.
max_appointments_per_participantintegerMaximum time slots a participant can sign up for; prevents overbooking.
min_appointments_per_participantintegerMinimum time slots a participant must sign up for; useful for requiring multiple sessions.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create an assignmentCANVAS_CREATE_ASSIGNMENTAcciónCreates a new assignment within a specified course in canvas lms.
CANVAS_CREATE_ASSIGNMENTAcciónCreates a new assignment within a specified course in canvas lms.
Parámetros de entrada
namestringObligatorioName of the assignment.
due_atstringDue date in ISO 8601 format.
positionintegerPosition in the assignment group's list; lower numbers appear first. If unspecified, added to the end.
course_idintegerObligatorioID of the course for the new assignment.
publishedbooleanIf true, assignment is published and visible to students. Defaults to false (draft).
unlock_atstringDate assignment becomes available to students, in ISO 8601 format.
descriptionstringDetailed HTML description, including instructions or requirements.
grading_typestringGrading type. Supported: 'pass_fail', 'percent', 'letter_grade', 'gpa_scale', 'points', 'not_graded'. Defaults to 'points' if unspecified.
integration_idstringUnique identifier if managed by a third-party integration (e.g., LTI ID).
points_possibleintegerMaximum points possible. Required unless grading_type is 'pass_fail' or 'not_graded'.
allowed_attemptsintegerNumber of submission attempts allowed. Use -1 for unlimited. Defaults to -1 (unlimited) if unspecified by the system.
submission_typesstring[]Submission types allowed. Common: 'online_text_entry', 'online_upload', 'on_paper', 'none', 'external_tool'. If unspecified, Canvas often assumes 'none'.
allowed_extensionsstring[]File extensions allowed if 'online_upload' is a submission type. If unspecified, all file types are allowed.
assignment_group_idintegerID of the assignment group for this assignment. If unspecified, may be added to a default or first available group.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create assignment overrideCANVAS_CREATE_ASSIGNMENT_OVERRIDEAcciónCreates an assignment override to adjust due/unlock/lock dates for an assignment in a course, targeting specific students (requires `title`), a group, or a course section; at least one target (`student ids`, `group id`, or `course section id`) is required.
CANVAS_CREATE_ASSIGNMENT_OVERRIDEAcciónCreates an assignment override to adjust due/unlock/lock dates for an assignment in a course, targeting specific students (requires `title`), a group, or a course section; at least one target (`student ids`, `group id`, or `course section id`) is required.
Parámetros de entrada
titlestringThe title for this assignment override. Required if `student_ids` are specified to identify the ad-hoc group.
due_atstringThe new due date for the assignment for the targeted entity (students, group, or section). Must be in ISO 8601 format.
lock_atstringThe new lock date (when the assignment becomes unavailable) for the targeted entity. Must be in ISO 8601 format.
group_idintegerThe ID of the group to target with this override. All students in this group will be affected.
course_idstringObligatorioThe ID of the course where the assignment exists and the override will be applied.
unlock_atstringThe new unlock date (when the assignment becomes available) for the targeted entity. Must be in ISO 8601 format.
student_idsinteger[]A list of student IDs to target with this override. If specified, a `title` is also required.
assignment_idstringObligatorioThe ID of the assignment for which this override is being created.
course_section_idintegerThe ID of the course section to target with this override. All students in this section will be affected.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create Calendar EventCANVAS_CREATE_CALENDAR_EVENTAcciónCreates a calendar event with options for recurrence (finite `rrule` series only), section-specific timings, and blackout dates within a specified context.
CANVAS_CREATE_CALENDAR_EVENTAcciónCreates a calendar event with options for recurrence (finite `rrule` series only), section-specific timings, and blackout dates within a specified context.
Parámetros de entrada
rrulestringiCalendar Recurrence Rule (RRULE) string for recurring events (e.g., 'FREQ=WEEKLY;BYDAY=MO,WE,FR'). Must define a finite series (include 'UNTIL' or 'COUNT').
titlestringShort, descriptive title for the event.
end_atstringdate-timeEnd date/time of the event (ISO 8601 'YYYY-MM-DDTHH:MM:SSZ').
all_daybooleanIf true, event spans the entire day; `start_at` and `end_at` times are ignored (date portion only).
start_atstringdate-timeStart date/time of the event (ISO 8601 'YYYY-MM-DDTHH:MM:SSZ').
duplicateobjectSettings for creating a series of identical events. See `DuplicateSettings`.
descriptionstringDetailed description; HTML allowed for rich formatting.
context_codestringObligatorioContext code for the calendar, e.g., 'course_123' (course), 'group_456' (group), 'user_789' (user), or 'account_1' (account).
blackout_datebooleanIf true, marks a blackout date not considered in course pacing calculations.
location_namestringName of the event's location (e.g., 'Conference Room A', 'Online').
child_event_dataobjectSection-specific start/end times. Keys are arbitrary identifiers; values are `ChildEventData` objects.
location_addressstringPhysical address of the event's location.
time_zone_editedstringTime zone for event creation/editing (IANA Time Zone Database or Rails TimeZone format, e.g., 'America/New_York').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create communication channelCANVAS_CREATE_COMMUNICATION_CHANNELAcciónCreates a new communication channel (e.g., email, sms, push) for an existing canvas user to receive notifications.
CANVAS_CREATE_COMMUNICATION_CHANNELAcciónCreates a new communication channel (e.g., email, sms, push) for an existing canvas user to receive notifications.
Parámetros de entrada
typestringObligatorioThe type of communication channel to create.
tokenstringA registration ID, device token, or equivalent. This is required if 'type' is 'push' and is provided by a push notification service when an app registers.
addressstringObligatorioThe address of the communication channel. For 'email' type, this is an email address. For 'sms' type, this is a phone number in E.164 format (e.g., +15551234567).
user_idstringObligatorioThe ID of the Canvas user for whom this communication channel will be created.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create content shareCANVAS_CREATE_CONTENT_SHAREAcciónShares a canvas content item to specified users, if the sender has necessary permissions and receiver ids are valid.
CANVAS_CREATE_CONTENT_SHAREAcciónShares a canvas content item to specified users, if the sender has necessary permissions and receiver ids are valid.
Parámetros de entrada
user_idstringObligatorioID of the user initiating the share; 'self' can be used for the authenticated user.
content_idintegerObligatorioUnique numerical identifier of the content item to be shared.
content_typestringObligatorioenumType of content being shared.
assignmentdiscussion_topicpagequizmodulemodule_itemreceiver_idsstring[]ObligatorioList of unique Canvas user IDs for recipients; must not be empty.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create conversationCANVAS_CREATE_CONVERSATIONAcciónUse to send messages in canvas by creating a new conversation or adding to an existing one; an existing conversation with the same recipients (and matching scope/filter, if specified) may be reused unless `force new` is true.
CANVAS_CREATE_CONVERSATIONAcciónUse to send messages in canvas by creating a new conversation or adding to an existing one; an existing conversation with the same recipients (and matching scope/filter, if specified) may be reused unless `force new` is true.
Parámetros de entrada
bodystringObligatorioThe content of the message to be sent.
modestringenumDetermines whether messages will be created/sent synchronously or asynchronously. 'sync' means the action waits for completion, 'async' means it returns immediately. Defaults to 'sync'.
syncasyncscopestringenumFilters conversations by a specific scope (e.g., 'unread', 'starred', 'archived') to potentially reuse an existing conversation matching this scope and other filter criteria. Affects which conversation is returned or updated if not forcing new.
unreadstarredarchivedfilterstring[]Array of conversation IDs or user IDs. Used with `scope` and `filter_mode` to find an existing conversation to reuse. If a match is found and `force_new` is not true, that conversation is used/updated instead of creating a new one.
subjectstringThe subject of the conversation. Maximum length is 255 characters.
force_newbooleanIf true, forces the creation of a new conversation, even if an existing private conversation with the same recipients, scope, and filters is found. If false or not provided, an existing matching conversation may be reused.
recipientsstring[]ObligatorioArray of recipient IDs. User IDs are numeric strings. Course/group IDs are strings prefixed with 'course_' or 'group_' respectively, followed by the ID (e.g., 'course_123', 'group_456').
filter_modestringenumSpecifies how the `filter` criteria are combined ('and', 'or'). Used in conjunction with `scope` and `filter` to identify an existing conversation for reuse. 'default' typically implies 'and'.
andordefaultcontext_codestringThe course or group ID that provides context for this conversation (e.g., 'course_123', 'group_456'). This associates the conversation with a specific course or group.
attachment_idsstring[]Array of attachment IDs from the sender's conversation attachments folder. These are IDs of files previously uploaded by the sender.
media_comment_idstringMedia comment ID of an audio or video file to be associated with this message. This ID refers to a media object previously created.
group_conversationbooleanIf true, a single group conversation is created with all recipients. If false or not provided, individual private conversations will be created with each recipient. Ignored if `force_new` is true and a new conversation is created.
media_comment_typestringenumType of the associated media file. Must be 'audio' or 'video' if `media_comment_id` is provided.
audiovideo
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create a courseCANVAS_CREATE_COURSEAcciónCreates a new course in canvas within a specified account, with comprehensive configuration options.
CANVAS_CREATE_COURSEAcciónCreates a new course in canvas within a specified account, with comprehensive configuration options.
Parámetros de entrada
namestringThe name of the course. If omitted, Canvas will default to 'Unnamed Course'.
offerbooleanIf true, the course will be made available to students (published) immediately upon creation. If false, it remains unpublished and hidden from students until explicitly published.
end_atstringThe end date and time for the course, in ISO8601 format (e.g., '2024-12-15T23:59:59Z'). If omitted, the course will not have a specific end date.
licensestringenumSpecifies the license for the course content.
privatecc_by_nc_ndcc_by_nc_sacc_by_nccc_by_ndcc_by_sacc_bypublic_domainterm_idstringThe unique identifier of the academic term (e.g., Fall 2024) to associate this course with.
start_atstringThe start date and time for the course, in ISO8601 format (e.g., '2024-09-01T00:00:00Z'). If omitted, the course will not have a specific start date.
enroll_mebooleanIf true, the user making this API request will be automatically enrolled in the newly created course as a teacher.
is_publicbooleanIf set to true, the course will be publicly visible to both authenticated and unauthenticated users. Otherwise, visibility is restricted.
time_zonestringThe time zone for the course, used for displaying deadlines and scheduling events. Accepts IANA time zone names (e.g., 'America/New_York') or Rails time zone names.
account_idstringObligatorioThe ID of the account in which the course will be created. This is a mandatory field.
course_codestringThe course code or abbreviation (e.g., 'CS101', 'HIST-202').
default_viewstringenumThe default landing page for the course after a user navigates to it.
feedwikimodulessyllabusassignmentscourse_formatstringenumThe delivery format of the course.
on_campusonlineblendedpost_manuallybooleanIf true, all grades for assignments must be manually posted by an instructor before they are visible to students. This enables the 'manual grading policy' feature for the course.
sis_course_idstringA unique identifier for the course from an external Student Information System (SIS). Used for synchronization.
syllabus_bodystringThe HTML content for the course's syllabus page. This can include text, images, links, and other rich content.
integration_idstringA unique identifier for the course from an external integration or third-party tool.
open_enrollmentbooleanIf set to true, the course allows open enrollment, meaning users can join without an invitation or instructor approval.
public_syllabusbooleanIf set to true, the course syllabus will be publicly visible to all users, including those not logged in.
self_enrollmentbooleanIf set to true, students can self-enroll in the course, potentially using a join code or public course listing.
hide_final_gradesbooleanIf set to true, the totals in the student grades summary page will be hidden from students, preventing them from seeing their final calculated grade.
public_descriptionstringA short, publicly visible description or summary of the course.
allow_wiki_commentsbooleanIf set to true, course members (students and instructors) will be able to add comments to wiki pages.
grading_standard_idintegerThe ID of an existing grading standard to be used for the course. This defines the mapping from percentage scores to letter grades (e.g., A, B, C).
grade_passback_settingstringConfigures how grades are passed back to an external system, typically an SIS. Valid options are 'nightly_sync' (grades sync daily), 'disabled' (no grade passback), or an empty string (often defaults to 'disabled').
enable_sis_reactivationbooleanIf true, and a course with the same `sis_course_id` was previously deleted, this action will attempt to reactivate and update that course instead of creating a new one. Requires `sis_course_id` to be provided.
is_public_to_auth_usersbooleanIf set to true, the course is publicly visible only to authenticated users on the platform.
public_syllabus_to_authbooleanIf set to true, the course syllabus will be visible to any authenticated user on the platform, even if they are not enrolled.
allow_student_wiki_editsbooleanIf set to true, students enrolled in the course will be able to edit and contribute to course wiki pages.
apply_assignment_group_weightsbooleanIf set to true, the final grade for the course will be calculated based on weighted assignment groups (e.g., Homework 30%, Exams 70%).
allow_student_forum_attachmentsbooleanIf set to true, students can attach files to their posts in course discussion forums and announcements.
restrict_enrollments_to_course_datesbooleanIf set to true, student enrollments will be active only between the course's `start_at` and `end_at` dates. Access outside these dates may be restricted.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create discussion entryCANVAS_CREATE_DISCUSSION_ENTRYAcciónTool to create a new entry in a canvas discussion topic. use when posting a message with optional attachments to a discussion topic.
CANVAS_CREATE_DISCUSSION_ENTRYAcciónTool to create a new entry in a canvas discussion topic. use when posting a message with optional attachments to a discussion topic.
Parámetros de entrada
messagestringObligatorioThe content of the discussion entry. Supports HTML formatting.
topic_idintegerObligatorioThe unique identifier of the discussion topic within the course.
course_idintegerObligatorioThe unique identifier of the Canvas course.
attachment_idsinteger[]A list of file attachment IDs to include with the new entry, if any.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create discussion topicCANVAS_CREATE_DISCUSSION_TOPICAcciónCreates a new discussion topic in a specified canvas course, allowing comprehensive configuration of its content, type, publication settings, engagement features, and associations.
CANVAS_CREATE_DISCUSSION_TOPICAcciónCreates a new discussion topic in a specified canvas course, allowing comprehensive configuration of its content, type, publication settings, engagement features, and associations.
Parámetros de entrada
titlestringObligatorioThe title of the new discussion topic.
pinnedbooleanSet to `true` to pin the topic, listing it in a 'Pinned Discussions' section for higher visibility. Defaults to `false`.
lock_atstringdate-timeThe datetime (ISO 8601 format) when the topic should be automatically locked, preventing further replies. If omitted, the topic will not automatically lock.
messagestringThe main content/message of the discussion topic. While not explicitly stated for this API endpoint, Canvas discussions generally support HTML for rich content formatting.
course_idintegerObligatorioThe unique identifier for the course where the discussion topic will be created.
publishedbooleanSet to `true` to publish the topic immediately, or `false` to save it as a draft. Defaults to `false` if not provided, creating a draft.
allow_ratingbooleanSet to `true` to allow users to rate entries in this topic. Defaults to `false`.
position_afterstringThe ID of another discussion topic within the same course. If provided, this new topic will be positioned immediately after the specified topic in the discussion list.
sort_by_ratingbooleanIf `allow_rating` is `true`, set this to `true` to sort discussion entries by their ratings. Defaults to `false`.
delayed_post_atstringdate-timeThe datetime (ISO 8601 format) when the topic should be automatically published. If set, `published` should ideally be `false` or omitted.
discussion_typestringThe type of discussion. Accepted values: 'side_comment' (allows replies to any message), 'threaded' (allows threaded replies), 'not_threaded' (linear discussion). Defaults to 'side_comment' if not specified.
is_announcementbooleanSet to `true` to mark this topic as an announcement. Announcements may appear in a special section or have different notification behavior. Defaults to `false`.
podcast_enabledbooleanSet to `true` to enable an associated podcast feed for this topic. Defaults to `false`.
group_category_idintegerThe ID of a group category within the course. If provided, the discussion topic will be associated with this group category, potentially creating group-specific discussions or restricting access. Example: A group discussion.
specific_sectionsstringA comma-separated string of section IDs to which this discussion topic should be restricted. If omitted, or an empty string is provided, the topic is available to all sections in the course.
require_initial_postbooleanSet to `true` to require users to make an initial post before they can view other replies in the topic. Defaults to `false`.
only_graders_can_ratebooleanIf `allow_rating` is `true`, set this to `true` to restrict rating privileges to graders only. Defaults to `false` (meaning any user can rate if `allow_rating` is true).
podcast_has_student_postsbooleanIf `podcast_enabled` is `true`, set this to `true` to include student posts in the podcast feed. Defaults to `false`.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create enrollmentCANVAS_CREATE_ENROLLMENTAcciónEnrolls a user in a canvas course with a specified role and status; `associated user id` is required if `enrollment type` is 'observerenrollment'.
CANVAS_CREATE_ENROLLMENTAcciónEnrolls a user in a canvas course with a specified role and status; `associated user id` is required if `enrollment type` is 'observerenrollment'.
Parámetros de entrada
end_atstringISO8601 end date/time for enrollment. If unspecified, may follow course/term dates or be indefinite.
notifybooleanIf true, sends notification to user. Default notification behavior varies if null/false.
role_idintegerID of a custom course-level role, potentially overriding `enrollment_type`.
user_idstringObligatorioThe ID of the user to be enrolled in the course.
start_atstringISO8601 start date/time for enrollment. If unspecified, may start immediately or align with course/term settings.
course_idintegerObligatorioThe ID of the course in which to enroll the user.
sis_user_idstringSIS (Student Information System) ID for the user; an alternative identifier.
self_enrolledbooleanTrue if self-initiated enrollment, typically with `self_enrollment_code`.
integration_idstringExternal unique identifier for linking with third-party systems.
enrollment_typestringenumEnrollment type determining role/permissions. Canvas defaults to 'StudentEnrollment' if unspecified.
StudentEnrollmentTeacherEnrollmentTaEnrollmentObserverEnrollmentDesignerEnrollmentenrollment_statestringenumState of enrollment: 'active', 'invited' (requires user acceptance), or 'inactive'.
activeinvitedinactivecourse_section_idintegerID of a specific course section for enrollment. If omitted, user enrolls in the course generally.
associated_user_idintegerFor 'ObserverEnrollment', the ID of the student to be observed.
self_enrollment_codestringCode for self-enrollment if `self_enrolled` is true.
limit_privileges_to_course_sectionbooleanIf true, confines user access to `course_section_id` (requires `course_section_id` to be set).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create FolderCANVAS_CREATE_FOLDERAcciónCreates a new folder in canvas within a specified context (e.g., course, user) and optional parent folder; ensure the context and any parent folder (specified by id or path, not both) already exist.
CANVAS_CREATE_FOLDERAcciónCreates a new folder in canvas within a specified context (e.g., course, user) and optional parent folder; ensure the context and any parent folder (specified by id or path, not both) already exist.
Parámetros de entrada
idstringObligatorioThe unique identifier of the context entity (e.g., course ID, user ID, group ID, folder ID, or account ID) where the folder will be created.
namestringObligatorioThe desired name for the new folder.
hiddenbooleanA boolean flag indicating whether the folder should be hidden upon creation. A hidden folder is typically not visible in the standard folder listings.
lockedbooleanA boolean flag indicating whether the folder should be locked upon creation. A locked folder typically restricts access or modifications.
lock_atstringThe date and time at which the folder should become locked, specified in ISO 8601 format (e.g., '2011-10-21T18:48Z').
positionintegerAn integer value to explicitly set the sort order or position of the folder among its siblings.
unlock_atstringThe date and time at which the folder should become unlocked, specified in ISO 8601 format (e.g., '2011-10-21T18:48Z').
context_typestringObligatorioenumSpecifies the context in which to create the folder. Valid contexts are 'courses', 'users', 'groups', 'folders', or 'accounts'.
coursesusersgroupsfoldersaccountsparent_folder_idstringThe ID of an existing parent folder within the specified context. If provided, the new folder will be created inside this parent folder. Cannot be used simultaneously with `parent_folder_path`.
parent_folder_pathstringThe full path to an existing parent folder within the specified context (e.g., 'course files/week 1/assignments'). If provided, the new folder will be created inside this parent folder. Cannot be used simultaneously with `parent_folder_id`.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create ModuleCANVAS_CREATE_MODULEAcciónCreates a new organizational module within a specified canvas lms course, with options for availability, sequencing, and prerequisites.
CANVAS_CREATE_MODULEAcciónCreates a new organizational module within a specified canvas lms course, with options for availability, sequencing, and prerequisites.
Parámetros de entrada
namestringObligatorioName for the new module.
positioninteger1-based position in the course's module list.
course_idstringObligatorioID of the course for the new module.
unlock_atstringISO 8601 datetime for module availability to students. If omitted, availability follows course settings.
publish_final_gradebooleanIf true, automatically publishes the student's final course grade upon module completion.
prerequisite_module_idsstring[]List of module IDs that are prerequisites for accessing this module.
require_sequential_progressbooleanIf true, students must complete items sequentially; if false, any order is allowed.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create a page for a courseCANVAS_CREATE_PAGE_FOR_COURSEAcciónCreates a new wiki page in a specified canvas course, with options for title, html body, editing permissions, publication, and designation as front page (which also requires publication).
CANVAS_CREATE_PAGE_FOR_COURSEAcciónCreates a new wiki page in a specified canvas course, with options for title, html body, editing permissions, publication, and designation as front page (which also requires publication).
Parámetros de entrada
bodystringHTML content of the new page. Must be valid HTML.
titlestringObligatorioTitle for the new wiki page.
course_idintegerObligatorioUnique identifier for the course.
publishedbooleanPublish the page upon creation. Defaults to false (draft).
front_pagebooleanSet as the front page for the course; page must also be published. Defaults to false.
editing_rolesstringComma-separated string of roles allowed to edit: 'teachers', 'students', 'members', 'public'. Defaults to 'teachers'.
notify_of_updatebooleanNotify users of changes to this page. Defaults to false.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create QuizCANVAS_CREATE_QUIZAcciónCreates a new quiz with various settings in a specified existing canvas course; `assignment group id` applies only to graded quiz types.
CANVAS_CREATE_QUIZAcciónCreates a new quiz with various settings in a specified existing canvas course; `assignment group id` applies only to graded quiz types.
Parámetros de entrada
titlestringObligatorioThe title of the quiz.
due_atstringThe date and time (ISO 8601 format) by which the quiz should be submitted.
lock_atstringThe date and time (ISO 8601 format) after which students can no longer submit the quiz.
course_idstringObligatorioThe ID of the course where the quiz will be created.
ip_filterstringAn optional comma-separated list of IP addresses or CIDR ranges (e.g., '192.168.1.0/24', '203.0.113.42') to restrict quiz access.
publishedbooleanIf true, the quiz will be published and visible to students according to availability dates and override settings. Default is typically false for new quizzes.
quiz_typestringenumSpecifies the type of quiz.
practice_quizassignmentgraded_surveysurveyunlock_atstringThe date and time (ISO 8601 format) when the quiz becomes available for students to take.
time_limitintegerThe time limit for the quiz in minutes. Use null or omit for no time limit.
access_codestringAn optional password students must enter to start the quiz.
descriptionstringA textual description of the quiz content and instructions.
cant_go_backbooleanIf true and `one_question_at_a_time` is also true, students cannot return to previous questions after submitting an answer for the current question. Default is false.
hide_resultsstringenumControls when students can see their quiz results. If null or omitted, results are shown immediately after submission.
alwaysuntil_after_last_attemptscoring_policystringenumIf multiple attempts are allowed, this determines which attempt's score is recorded.
keep_highestkeep_latestshuffle_answersbooleanIf true, the order of answers for questions will be randomized for each student. Default is typically false.
allowed_attemptsintegerThe number of times a student is allowed to take the quiz. Use -1 for unlimited attempts. Omit for course/quiz default.
one_time_resultsbooleanIf true and `hide_results` is also set (not null), students can only view their results once, immediately after submitting the quiz. Has no effect if `hide_results` is null. Default is false.
assignment_group_idintegerThe ID of the assignment group to associate the quiz with. This is applicable only if the quiz is graded (e.g., 'assignment' or 'graded_survey' type).
show_correct_answersbooleanIf true, students will be able to see the correct answers when viewing their results (subject to other settings like `show_correct_answers_at` and `hide_correct_answers_at`). Default is typically true.
one_question_at_a_timebooleanIf true, students will see one question at a time and must navigate sequentially. Default is false.
hide_correct_answers_atstringThe date and time (ISO 8601 format) after which correct answers will be hidden from students. Requires `show_correct_answers` to be true.
show_correct_answers_atstringThe date and time (ISO 8601 format) when correct answers will become visible to students. Requires `show_correct_answers` to be true.
only_visible_to_overridesbooleanIf true, the quiz is hidden from the general student population and only accessible to students with specific assignment overrides. Default is false.
show_correct_answers_last_attemptbooleanIf true, correct answers will only be shown to students after their last allowed attempt. Requires `show_correct_answers` to be true.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create a quiz questionCANVAS_CREATE_QUIZ_QUESTIONAcciónCreates a new question for an existing quiz within a course; if `answers` are provided, their structure must align with `question type`, and any `quiz group id` must be valid for an existing group in the quiz.
CANVAS_CREATE_QUIZ_QUESTIONAcciónCreates a new question for an existing quiz within a course; if `answers` are provided, their structure must align with `question type`, and any `quiz group id` must be valid for an existing group in the quiz.
Parámetros de entrada
answersobject[]Answer objects, if provided. Structure is critical and must align with `question_type`. Refer to Canvas API documentation for format details per type.
quiz_idintegerObligatorioIdentifier of the quiz to add the question to.
positioninteger1-based display order in the quiz; defaults to end if omitted.
course_idintegerObligatorioIdentifier of the course containing the quiz.
question_namestringObligatorioDescriptive name for identification, especially in question banks.
question_textstringObligatorioMain question content, presented to the student; supports HTML.
question_typestringObligatorioenumQuestion format and answer options. See `QuestionType` enum.
calculated_questionessay_questionfile_upload_questionfill_in_multiple_blanks_questionmatching_questionmultiple_answers_questionmultiple_choice_questionmultiple_dropdowns_questionnumerical_questionshort_answer_questiontext_only_questiontrue_false_questionquiz_group_idintegerID of an existing quiz group for this question; for organization within the quiz.
points_possibleintegerMaximum points for a correct answer.
correct_commentsstringFeedback (text/HTML) for a correct answer.
neutral_commentsstringFeedback (text/HTML) regardless of answer correctness.
incorrect_commentsstringFeedback (text/HTML) for an incorrect answer.
text_after_answersstringAdditional text/HTML displayed post-submission (e.g., explanations).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete appointment groupCANVAS_DELETE_APPOINTMENT_GROUPAcciónPermanently deletes an existing appointment group by its id; associated appointments may also be canceled or affected.
CANVAS_DELETE_APPOINTMENT_GROUPAcciónPermanently deletes an existing appointment group by its id; associated appointments may also be canceled or affected.
Parámetros de entrada
cancel_reasonstringAn optional reason for deleting the appointment group.
appointment_group_idstringObligatorioThe unique identifier of the appointment group to be deleted.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete an assignmentCANVAS_DELETE_ASSIGNMENTAcciónSoft-deletes a specific assignment within a course, returning the assignment object with its `workflow state` updated to 'deleted'.
CANVAS_DELETE_ASSIGNMENTAcciónSoft-deletes a specific assignment within a course, returning the assignment object with its `workflow state` updated to 'deleted'.
Parámetros de entrada
course_idintegerObligatorioThe unique identifier of the course to which the assignment belongs.
assignment_idintegerObligatorioThe unique identifier of the assignment to be deleted.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete a folderCANVAS_DELETE_FOLDERAcciónPermanently deletes an existing folder specified by its unique id.
CANVAS_DELETE_FOLDERAcciónPermanently deletes an existing folder specified by its unique id.
Parámetros de entrada
idstringObligatorioUnique identifier of the folder to be deleted.
forcebooleanIf `true`, deletes the folder even if it contains items. If `false` (default), the folder must be empty for deletion.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete quizCANVAS_DELETE_QUIZAcciónPermanently deletes the quiz identified by `quiz id` from the course identified by `course id`; this action cannot be undone.
CANVAS_DELETE_QUIZAcciónPermanently deletes the quiz identified by `quiz id` from the course identified by `course id`; this action cannot be undone.
Parámetros de entrada
quiz_idstringObligatorioThe unique identifier for the quiz to be deleted.
course_idstringObligatorioThe unique identifier for the course from which the quiz will be deleted.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get current gradesCANVAS_DEPARTMENT_LEVEL_GRADE_DATA_FOR_CURRENT_GRADESAcciónFetches current, aggregated grade data from canvas analytics for a specified account id.
CANVAS_DEPARTMENT_LEVEL_GRADE_DATA_FOR_CURRENT_GRADESAcciónFetches current, aggregated grade data from canvas analytics for a specified account id.
Parámetros de entrada
account_idintegerObligatorioUnique Canvas account ID (often a department or sub-account) for which to retrieve current grade analytics.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get term grade dataCANVAS_DEPARTMENT_LEVEL_GRADE_DATA_FOR_TERM_GRADESAcciónRetrieves department-level aggregated grade data for a specific academic term within a canvas account.
CANVAS_DEPARTMENT_LEVEL_GRADE_DATA_FOR_TERM_GRADESAcciónRetrieves department-level aggregated grade data for a specific academic term within a canvas account.
Parámetros de entrada
term_idintegerObligatorioUnique identifier for the academic term to request grade data for.
account_idintegerObligatorioUnique identifier for the Canvas account to retrieve analytics data from.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Edit assignmentCANVAS_EDIT_ASSIGNMENTAcciónUpdates an existing assignment in a canvas course (identified by `course id` and `assignment id`); only attributes explicitly provided in the request are modified.
CANVAS_EDIT_ASSIGNMENTAcciónUpdates an existing assignment in a canvas course (identified by `course id` and `assignment id`); only attributes explicitly provided in the request are modified.
Parámetros de entrada
namestringThe new name for the assignment.
due_atstringThe new due date for the assignment, formatted in ISO 8601 (e.g., '2025-10-21T18:48:00Z').
positionintegerThe new position of this assignment within its assignment group when displayed in lists. Lower numbers appear first.
course_idintegerObligatorioThe unique identifier for the course containing the assignment.
publishedbooleanWhether the assignment should be published. Set to `True` to publish, `False` to unpublish. If not provided, the existing published status may be retained or it might default to `False` depending on the API's behavior for partial updates.
unlock_atstringThe new date when the assignment becomes available to students, formatted in ISO 8601 (e.g., '2025-10-21T18:48:00Z').
descriptionstringThe new HTML content for the assignment's description.
grading_typestringThe new grading type for the assignment. Supported types include 'pass_fail', 'percent', 'letter_grade', 'gpa_scale', 'points', 'not_graded'.
assignment_idintegerObligatorioThe unique identifier for the assignment to be edited.
integration_idstringThe new unique identifier for the assignment from a third-party integration (e.g., an external tool).
points_possibleintegerThe new maximum number of points possible for the assignment.
allowed_attemptsintegerThe new number of submission attempts allowed for the assignment. Use -1 for unlimited attempts.
submission_typesstring[]A list of new submission types supported for the assignment. Valid types include 'online_quiz', 'none', 'on_paper', 'discussion_topic', 'external_tool', 'online_upload', 'online_text_entry', 'online_url'.
allowed_extensionsstring[]File extensions (e.g., 'pdf', 'docx') allowed if `submission_types` includes 'online_upload'.
assignment_group_idintegerThe unique identifier of the assignment group to which this assignment should be moved or associated.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Edit a quizCANVAS_EDIT_QUIZAcciónModifies an existing canvas quiz; only attributes with provided values in the request are updated.
CANVAS_EDIT_QUIZAcciónModifies an existing canvas quiz; only attributes with provided values in the request are updated.
Parámetros de entrada
titlestringNew title for the quiz. If None, the title will not be updated.
due_atstringDue date/time for the quiz (ISO 8601 format). No update if None.
lock_atstringWhen students can no longer take the quiz (ISO 8601 format). No update if None.
quiz_idstringObligatorioIdentifier for the quiz to be updated.
course_idstringObligatorioIdentifier for the course in which the quiz resides.
ip_filterstringA comma-separated list of IP addresses or CIDR netmasks (e.g., '192.168.1.1/24') that are allowed to access the quiz. If None, this setting will not be updated.
publishedbooleanIf true, the quiz is published and visible to students. If false, it is unpublished. If None, the publication status will not be updated.
quiz_typestringenumThe type of the quiz. If None, the type will not be updated.
practice_quizassignmentgraded_surveysurveyunlock_atstringWhen the quiz becomes available (ISO 8601 format). No update if None.
time_limitintegerTime limit for the quiz in minutes. Use null or omit to remove an existing time limit, effectively setting no time limit. If None, the time limit will not be updated.
access_codestringA password to restrict access to the quiz. Setting this to an empty string will remove an existing access code. If None, the access code will not be updated.
descriptionstringNew HTML description for the quiz. If None, the description will not be updated.
cant_go_backbooleanIf true, students cannot go back to previous questions after answering them (only applicable if `one_question_at_a_time` is true). If None, this setting will not be updated.
hide_resultsstringenumSpecifies when results should be hidden from students. Use 'always' to hide results completely or 'until_after_last_attempt' to hide them until the student has completed their final attempt. If None, this setting will not be updated.
alwaysuntil_after_last_attemptscoring_policystringenumDetermines which score is kept if multiple attempts are allowed ('keep_highest' or 'keep_latest'). If None, this setting will not be updated.
keep_highestkeep_latestshuffle_answersbooleanIf true, answers to quiz questions will be shuffled for each student. If None, this setting will not be updated.
allowed_attemptsintegerNumber of attempts a student is allowed to take for the quiz. Use -1 for unlimited attempts. If None, this setting will not be updated.
notify_of_updatebooleanIf true, sends notifications to users about the quiz update.
one_time_resultsbooleanIf true, students can only view their quiz results once (this option is disabled if `allowed_attempts` > 1). If None, this setting will not be updated.
assignment_group_idintegerThe ID of the assignment group to associate with the quiz. This is relevant for graded quizzes (e.g., 'assignment', 'graded_survey'). If None, the assignment group will not be updated.
show_correct_answersbooleanIf true, students can see the correct answers after submitting the quiz (subject to other restrictions like `hide_results`, `show_correct_answers_at`, `hide_correct_answers_at`). If None, this setting will not be updated.
one_question_at_a_timebooleanIf true, students will see one question at a time. If None, this setting will not be updated.
hide_correct_answers_atstringWhen correct answers will be hidden (ISO 8601 format). No update if None.
show_correct_answers_atstringWhen correct answers become visible (ISO 8601 format). No update if None.
only_visible_to_overridesbooleanIf true, the quiz is only visible to students with specific overridden due dates. If None, this setting will not be updated.
show_correct_answers_last_attemptbooleanIf true, correct answers will only be shown after the student's final attempt for quizzes that allow multiple attempts. If None, this setting will not be updated.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Export contentCANVAS_EXPORT_CONTENTAcciónUse to initiate an asynchronous export of content (e.g., common cartridge, qti, zip) from an existing canvas course, returning an export id and progress url.
CANVAS_EXPORT_CONTENTAcciónUse to initiate an asynchronous export of content (e.g., common cartridge, qti, zip) from an existing canvas course, returning an export id and progress url.
Parámetros de entrada
course_idstringObligatorioThe unique identifier for the course whose content is to be exported.
export_typestringObligatorioenumFormat for the exported content.
common_cartridgeqtizipskip_notificationsbooleanIf true, suppresses progress notifications to the initiating user.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch DataCANVAS_FETCH_DATAAcciónFetches a specific category of canvas data (e.g., accounts, courses, users) by setting exactly one `get *` boolean flag to true and providing any associated ids. supports pagination with per page (default 100, max 100) and page (default 1) parameters to fetch large datasets.
CANVAS_FETCH_DATAAcciónFetches a specific category of canvas data (e.g., accounts, courses, users) by setting exactly one `get *` boolean flag to true and providing any associated ids. supports pagination with per page (default 100, max 100) and page (default 1) parameters to fetch large datasets.
Parámetros de entrada
pageintegerPage number to fetch (1-indexed). Use to get results beyond the first page.
user_idintegerCanvas user ID, required when `get_user_courses` is true.
per_pageintegerNumber of items to return per page. Maximum is typically 100. Higher values fetch more data in a single request.
course_idintegerCanvas course ID, required if fetching course-specific data (e.g., assignments, files, users for a course).
get_filesbooleanFetches files for a specific course (requires `course_id`).
get_pagesbooleanFetches pages for a specific course (requires `course_id`).
get_usersbooleanFetches users for an account (requires `account_id`) or a course (requires `course_id`), optionally filter course users by `search_term`.
account_idintegerCanvas account ID (e.g., numerical ID or 'self'), required when `get_users` is true for an account. Can be found via `get_accounts` or use 'self'.
get_coursesbooleanFetches courses for the current user, optionally filtered by `enrollment_type` and `enrollment_state`.
get_quizzesbooleanFetches quizzes for a specific course (requires `course_id`).
search_termstringSearch term to filter results when `get_users` (for a course) or `get_discussion_topics` is true.
get_accountsbooleanFetches Canvas accounts accessible to the current user.
assignment_idintegerCanvas assignment ID, required when `get_submissions` is true.
enrollment_typestringFilter for `get_courses` or `get_user_courses` by enrollment type.
get_assignmentsbooleanFetches assignments for a specific course (requires `course_id`).
get_submissionsbooleanFetches submissions for an assignment within a course (requires `course_id` and `assignment_id`).
enrollment_statestringFilter for `get_courses` or `get_user_courses` by enrollment state.
get_user_coursesbooleanFetches courses for a specific user (requires `user_id`), optionally filtered by `enrollment_type` and `enrollment_state`.
only_announcementsbooleanWhen `get_discussion_topics` is true: if true, retrieves only announcements; if false, retrieves only discussion topics; if not specified, retrieves discussion topics (defaults to false).
get_discussion_topicsbooleanFetches discussion topics for a specific course (requires `course_id`). Use `only_announcements` to control whether to fetch announcements only (true), discussion topics only (false), or use default behavior (None). Can be filtered by `search_term`.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Canvas accountsCANVAS_GET_ACCOUNTSAcciónRetrieves all canvas accounts accessible to the authenticated user.
CANVAS_GET_ACCOUNTSAcciónRetrieves all canvas accounts accessible to the authenticated user.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get all assignmentsCANVAS_GET_ALL_ASSIGNMENTSAcciónRetrieves assignments for a specified canvas course.
CANVAS_GET_ALL_ASSIGNMENTSAcciónRetrieves assignments for a specified canvas course.
Parámetros de entrada
per_pageintegerThe number of assignments to return per page.
course_idintegerObligatorioThe unique identifier of the course from which to retrieve assignments.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get all usersCANVAS_GET_ALL_USERSAcciónRetrieves a list of users for a specified canvas `account id` (use 'self' for the current user's root account), supporting filtering, sorting, and pagination.
CANVAS_GET_ALL_USERSAcciónRetrieves a list of users for a specified canvas `account id` (use 'self' for the current user's root account), supporting filtering, sorting, and pagination.
Parámetros de entrada
pageintegerPage number for pagination (1-indexed).
sortstringField to sort users by (e.g., 'username', 'email', 'sis_id', 'integration_id', 'last_login').
orderstringSort direction: 'asc' (ascending) or 'desc' (descending).
per_pageintegerNumber of users per page (max 100).
account_idstringObligatorioUnique identifier for the Canvas account; use 'self' for the current user's root account.
search_termstringFilter users by name, username, or email.
enrollment_typestring[]Filter users by enrollment type (e.g., 'student', 'teacher', 'ta', 'observer', 'designer').
include_deleted_usersbooleanIf true, include users marked as deleted.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get assignmentCANVAS_GET_ASSIGNMENTAcciónRetrieves detailed information for a specific assignment within a given course in canvas.
CANVAS_GET_ASSIGNMENTAcciónRetrieves detailed information for a specific assignment within a given course in canvas.
Parámetros de entrada
course_idintegerObligatorioUnique identifier for the course containing the assignment.
assignment_idintegerObligatorioUnique identifier for the assignment to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Assignment RubricCANVAS_GET_ASSIGNMENT_RUBRICAcciónFetches the detailed rubric for a specified assignment within a canvas course; fails if the assignment has no associated rubric.
CANVAS_GET_ASSIGNMENT_RUBRICAcciónFetches the detailed rubric for a specified assignment within a canvas course; fails if the assignment has no associated rubric.
Parámetros de entrada
course_idstringObligatorioUnique identifier for the course.
assignment_idstringObligatorioUnique identifier for the assignment.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Course ActivityCANVAS_GET_COURSE_LEVEL_PARTICIPATION_DATAAcciónRetrieves daily activity analytics, such as page views and participation events, for a specified canvas course.
CANVAS_GET_COURSE_LEVEL_PARTICIPATION_DATAAcciónRetrieves daily activity analytics, such as page views and participation events, for a specified canvas course.
Parámetros de entrada
course_idintegerObligatorioThe unique numerical identifier of the Canvas course.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Current UserCANVAS_GET_CURRENT_USERAcciónRetrieves detailed information about the currently authenticated user from the canvas lms.
CANVAS_GET_CURRENT_USERAcciónRetrieves detailed information about the currently authenticated user from the canvas lms.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get department-level completed statisticsCANVAS_GET_DEPARTMENT_LEVEL_COMPLETED_STATISTICSAcciónRetrieves numeric statistics for all completed courses for a specified canvas account id; the account must exist.
CANVAS_GET_DEPARTMENT_LEVEL_COMPLETED_STATISTICSAcciónRetrieves numeric statistics for all completed courses for a specified canvas account id; the account must exist.
Parámetros de entrada
account_idintegerObligatorioUnique identifier for the Canvas account.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get department level current statisticsCANVAS_GET_DEPARTMENT_LEVEL_CURRENT_STATISTICSAcciónFetches a snapshot of current numerical statistics for a canvas account, requiring its valid id.
CANVAS_GET_DEPARTMENT_LEVEL_CURRENT_STATISTICSAcciónFetches a snapshot of current numerical statistics for a canvas account, requiring its valid id.
Parámetros de entrada
account_idintegerObligatorioThe unique identifier for the Canvas account (which may represent a department) for which to retrieve current statistics.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get department level completed gradesCANVAS_GET_DEPARTMENT_LEVEL_GRADE_DATA_COMPLETED_GRADESAcciónRetrieves the distribution of final grades (0-100, binned to whole numbers) for all completed courses in a canvas account, where each data point represents one student's final grade in one course.
CANVAS_GET_DEPARTMENT_LEVEL_GRADE_DATA_COMPLETED_GRADESAcciónRetrieves the distribution of final grades (0-100, binned to whole numbers) for all completed courses in a canvas account, where each data point represents one student's final grade in one course.
Parámetros de entrada
account_idintegerObligatorioUnique identifier of the Canvas account.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get department level term statisticsCANVAS_GET_DEPARTMENT_LEVEL_TERM_STATISTICSAcciónRetrieves department-level academic term statistics (e.g., enrollment, activity, grades) for a specified account and term in canvas, provided analytics data is available.
CANVAS_GET_DEPARTMENT_LEVEL_TERM_STATISTICSAcciónRetrieves department-level academic term statistics (e.g., enrollment, activity, grades) for a specified account and term in canvas, provided analytics data is available.
Parámetros de entrada
term_idintegerObligatorioThe unique identifier for the academic term.
account_idintegerObligatorioThe unique identifier for the Canvas account (e.g., a specific department).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get enrollment by IDCANVAS_GET_ENROLLMENT_BY_IDAcciónRetrieves a specific enrollment by its id within a given account.
CANVAS_GET_ENROLLMENT_BY_IDAcciónRetrieves a specific enrollment by its id within a given account.
Parámetros de entrada
idstringObligatorioThe unique identifier for the enrollment object to be retrieved.
account_idstringObligatorioThe unique identifier for the account in which the enrollment exists. Often 'self' can be used for the current user's account.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get gradebook history daysCANVAS_GET_GRADEBOOK_HISTORY_DAYSAcciónRetrieves a chronological list of dates with grading activity and the active graders for a specified course.
CANVAS_GET_GRADEBOOK_HISTORY_DAYSAcciónRetrieves a chronological list of dates with grading activity and the active graders for a specified course.
Parámetros de entrada
course_idstringObligatorioThe unique identifier for the course for which to retrieve the gradebook history days.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Page for a CourseCANVAS_GET_PAGE_FOR_COURSEAcciónRetrieves a specific content page (wiki or content page) by its url or numeric id from a specified canvas course.
CANVAS_GET_PAGE_FOR_COURSEAcciónRetrieves a specific content page (wiki or content page) by its url or numeric id from a specified canvas course.
Parámetros de entrada
course_idstringObligatorioThe unique identifier for the Canvas course.
url_or_idstringObligatorioThe URL (e.g., 'my-first-page') or the numeric ID of the page. If a page URL might be identical to another page's numeric ID, prefix the ID with 'page_id:' (e.g., 'page_id:5678').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get quiz submissionsCANVAS_GET_QUIZ_SUBMISSIONSAcciónRetrieves all submissions for a specific quiz within a course; ensure `course id` and `quiz id` are valid and the quiz belongs to the course.
CANVAS_GET_QUIZ_SUBMISSIONSAcciónRetrieves all submissions for a specific quiz within a course; ensure `course id` and `quiz id` are valid and the quiz belongs to the course.
Parámetros de entrada
includestring[]Optional. Specifies related resources like 'submission', 'quiz', or 'user' to include with each submission. If omitted or empty, minimal data is returned.
quiz_idstringObligatorioThe unique ID of the quiz.
course_idstringObligatorioThe unique ID of the course.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get report statusCANVAS_GET_REPORT_STATUSAcciónRetrieves the status of a previously initiated report in a canvas account, specified by its type and id.
CANVAS_GET_REPORT_STATUSAcciónRetrieves the status of a previously initiated report in a canvas account, specified by its type and id.
Parámetros de entrada
idintegerObligatorioUnique identifier of the specific report instance, usually obtained when report generation is initiated.
reportstringObligatorioType or name of the report, typically a predefined report type within Canvas.
account_idintegerObligatorioUnique identifier for the Canvas account.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get a single courseCANVAS_GET_SINGLE_COURSEAcciónRetrieves detailed information for a specific canvas course using its `course id`, which must be valid, and allows for including additional data fields in the response via the `include` parameter.
CANVAS_GET_SINGLE_COURSEAcciónRetrieves detailed information for a specific canvas course using its `course id`, which must be valid, and allows for including additional data fields in the response via the `include` parameter.
Parámetros de entrada
includestring[]Specifies optional additional data to include with the course response. Allowed values: 'needs_grading_count', 'syllabus_body', 'public_description', 'total_scores', 'current_grading_period_scores', 'term', 'account', 'course_progress', 'sections', 'storage_quota_used_mb', 'total_students', 'passback_status', 'favorites', 'teachers', 'observed_users', 'all_courses', 'permissions', 'course_image', 'banner_image', 'concluded', 'lti_context_id', 'post_manually'.
course_idintegerObligatorioThe unique identifier for the Canvas course to retrieve.
teacher_limitintegerIf 'teachers' is in `include`, limits the number of teacher enrollments returned; API default applies otherwise.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get single submissionCANVAS_GET_SINGLE_SUBMISSIONAcciónRetrieves a specific submission for an assignment made by a particular user within a designated course.
CANVAS_GET_SINGLE_SUBMISSIONAcciónRetrieves a specific submission for an assignment made by a particular user within a designated course.
Parámetros de entrada
includestring[]Additional related resources to include with the submission. Common values: 'submission_history', 'submission_comments', 'rubric_assessment', 'assignment', 'course', 'user', 'group', 'visibility', 'read_status'.
user_idintegerObligatorioID of the user whose submission is being retrieved, or 'self' for the current authenticated user.
course_idintegerObligatorioID of the course.
assignment_idintegerObligatorioID of the assignment.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get submission filesCANVAS_GET_SUBMISSION_FILESAcciónRetrieves files from a student's canvas assignment submission, processing text, binary, and zip files, and providing s3 download urls if s3 integration is active and uploads are successful.
CANVAS_GET_SUBMISSION_FILESAcciónRetrieves files from a student's canvas assignment submission, processing text, binary, and zip files, and providing s3 download urls if s3 integration is active and uploads are successful.
Parámetros de entrada
user_idstringObligatorioID of the user (student) whose submission files are sought.
course_idstringObligatorioID of the Canvas course.
assignment_idstringObligatorioID of the assignment.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get user assignment analyticsCANVAS_GET_USER_ASSIGNMENT_ANALYTICSAcciónFetches detailed assignment-level analytics for a specific student in a designated course, including submission details and class performance statistics.
CANVAS_GET_USER_ASSIGNMENT_ANALYTICSAcciónFetches detailed assignment-level analytics for a specific student in a designated course, including submission details and class performance statistics.
Parámetros de entrada
course_idintegerObligatorioThe unique identifier for the course.
student_idintegerObligatorioThe unique identifier for the student.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get user course progressCANVAS_GET_USER_COURSE_PROGRESSAcciónRetrieves the academic progress of a specific user within a given course.
CANVAS_GET_USER_COURSE_PROGRESSAcciónRetrieves the academic progress of a specific user within a given course.
Parámetros de entrada
user_idstringObligatorioThe unique identifier of the user whose course progress is being requested. Use 'self' to fetch progress for the currently authenticated user.
course_idintegerObligatorioThe unique numerical identifier of the course for which progress is being requested.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get user participation analyticsCANVAS_GET_USER_PARTICIPATION_ANALYTICSAcciónRetrieves page view activity and participation details for a specific student enrolled in a designated course.
CANVAS_GET_USER_PARTICIPATION_ANALYTICSAcciónRetrieves page view activity and participation details for a specific student enrolled in a designated course.
Parámetros de entrada
course_idintegerObligatorioThe unique identifier of the course for which to retrieve analytics.
student_idintegerObligatorioThe unique identifier of the student for whom to retrieve analytics.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get User ProfileCANVAS_GET_USER_PROFILEAcciónRetrieves profile information for an existing canvas user.
CANVAS_GET_USER_PROFILEAcciónRetrieves profile information for an existing canvas user.
Parámetros de entrada
user_idintegerObligatorioUnique identifier for the user.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Grade or comment on a submissionCANVAS_GRADE_COMMENT_SUBMISSIONAcciónUpdates a student's assignment submission with a grade, comment, sticker, or status change; requires `course id`, `assignment id`, `user id`, and at least one update field.
CANVAS_GRADE_COMMENT_SUBMISSIONAcciónUpdates a student's assignment submission with a grade, comment, sticker, or status change; requires `course id`, `assignment id`, `user id`, and at least one update field.
Parámetros de entrada
excusebooleanIf true, marks submission 'excused'. Excused assignments typically don't affect total grade.
attemptintegerSpecific attempt number for the comment, if multiple attempts allowed.
stickerstringThe name of a sticker to apply to the submission (e.g., 'apple', 'star').
user_idintegerObligatorioThe unique identifier for the user (student) whose submission is being addressed.
course_idintegerObligatorioThe unique identifier for the course.
posted_gradestringGrade/score to assign (e.g., '95', 'A-'). Updates 'score' and 'grade' in Canvas.
text_commentstringA textual comment to add to the submission.
assignment_idintegerObligatorioThe unique identifier for the assignment within the course.
group_commentbooleanIf true, comment is visible to student's group (if a group assignment).
media_comment_idstringIdentifier for a pre-existing media comment. Obtaining this ID may require UI interaction due to Canvas API limitations for its management.
late_policy_statusstringSets late policy status. If omitted, existing status is unchanged.
media_comment_typestringType of media comment (e.g., 'audio', 'video'), relevant if `media_comment_id` is provided.
seconds_late_overrideintegerOverrides calculated lateness in seconds; used with `late_policy_status` or for manual adjustment.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Accounts for Course AdminsCANVAS_LIST_ACCOUNTS_FOR_COURSE_ADMINSAcciónRetrieves canvas accounts visible to the current user due to their course-level administrative roles; no request parameters are needed.
CANVAS_LIST_ACCOUNTS_FOR_COURSE_ADMINSAcciónRetrieves canvas accounts visible to the current user due to their course-level administrative roles; no request parameters are needed.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List all foldersCANVAS_LIST_ALL_FOLDERSAcciónRetrieves the first page of folders for a specified canvas course id; this action is scoped to courses only.
CANVAS_LIST_ALL_FOLDERSAcciónRetrieves the first page of folders for a specified canvas course id; this action is scoped to courses only.
Parámetros de entrada
idstringObligatorioThe unique identifier of the Canvas course for which to list folders. This ID must correspond to an existing course.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List appointment groupsCANVAS_LIST_APPOINTMENT_GROUPSAcciónRetrieves a list of canvas appointment groups based on specified filters; any provided `context codes` must be valid and accessible by the user.
CANVAS_LIST_APPOINTMENT_GROUPSAcciónRetrieves a list of canvas appointment groups based on specified filters; any provided `context codes` must be valid and accessible by the user.
Parámetros de entrada
scopestringDetermines the scope of appointment groups to retrieve. For example, 'reservable' returns groups the user can sign up for.
includestring[]List of additional data to include with each appointment group. Possible values: 'appointments', 'child_events', 'participant_count', 'reserved_times', 'all_context_codes'.
context_codesstring[]List of context codes (e.g., 'course_123' or 'group_456') to filter appointment groups by specific courses or groups. If omitted, groups from all relevant contexts are returned.
include_past_appointmentsbooleanIf true, appointment groups that have already passed will be included in the results. Defaults to false.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List assignment submissionsCANVAS_LIST_ASSIGNMENT_SUBMISSIONSAcciónRetrieves submissions for a specific assignment within a course, optionally including related resources or grouping by student group for group assignments. supports pagination to retrieve more than the default 10 submissions.
CANVAS_LIST_ASSIGNMENT_SUBMISSIONSAcciónRetrieves submissions for a specific assignment within a course, optionally including related resources or grouping by student group for group assignments. supports pagination to retrieve more than the default 10 submissions.
Parámetros de entrada
pageintegerPage number for pagination (1-indexed). Use to get results beyond the first page.
groupedbooleanIf set to true, and the assignment is a group assignment, the submissions will be grouped by student group. Otherwise, submissions are returned ungrouped. Defaults to false if not provided.
includestring[]A list of optional related resources to include in the response for each submission. Common values include 'submission_history', 'submission_comments', 'user', and 'assignment'.
per_pageintegerNumber of submissions to return per page (max 100). If omitted, Canvas default (10) is used. Set to a higher value (e.g., 100) to get more submissions.
course_idintegerObligatorioThe unique identifier of the course.
assignment_idintegerObligatorioThe unique identifier of the assignment.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Available ReportsCANVAS_LIST_AVAILABLE_REPORTSAcciónLists available reports (including those that can be or have been generated) for a valid canvas account id.
CANVAS_LIST_AVAILABLE_REPORTSAcciónLists available reports (including those that can be or have been generated) for a valid canvas account id.
Parámetros de entrada
account_idintegerObligatorioThe unique identifier for the Canvas account for which to list available reports. This ID can typically be found in the Canvas URL or account settings.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List calendar events for a userCANVAS_LIST_CALENDAR_EVENTS_FOR_USERAcciónRetrieves calendar events and assignments for a specific user from canvas lms, supporting extensive filtering options detailed in the request schema.
CANVAS_LIST_CALENDAR_EVENTS_FOR_USERAcciónRetrieves calendar events and assignments for a specific user from canvas lms, supporting extensive filtering options detailed in the request schema.
Parámetros de entrada
typestringType of calendar item to filter by. Use 'event' for general calendar events or 'assignment' for assignments.
undatedbooleanIf true, only undated events will be returned. This filter is ignored if 'all_events' is true.
user_idintegerObligatorioThe unique identifier for the Canvas user whose calendar events are to be listed.
end_datestringThe end date for filtering events, in ISO 8601 format (e.g., 'YYYY-MM-DDTHH:MM:SSZ' or 'YYYY-MM-DD'). Events occurring on or before this date will be returned. This filter is ignored if 'all_events' is true.
excludesstring[]Assignment attributes to exclude (e.g., 'description', 'html_url') if items are assignments. No effect on non-assignment events.
includesstring[]Optional related resources to include in the response (e.g., 'submission', 'assignment_visibility'). E.g., 'submission' adds submission data for assignments.
all_eventsbooleanIf true, returns all calendar events for the user, overriding 'start_date', 'end_date', and 'undated' filters.
start_datestringThe start date for filtering events, in ISO 8601 format (e.g., 'YYYY-MM-DDTHH:MM:SSZ' or 'YYYY-MM-DD'). Events occurring on or after this date will be returned. This filter is ignored if 'all_events' is true.
blackout_datebooleanIf true, retrieves only 'blackout dates' (e.g., dates when a course might be unavailable).
context_codesstring[]Context codes (e.g., 'course_123', 'group_456', 'user_self') to filter events by. If omitted, events from all contexts visible to the user are returned.
important_datesbooleanIf true, retrieves only events marked 'important_dates' (e.g., course announcements with specific dates).
submission_typesstring[]Submission types (e.g., 'online_quiz', 'on_paper') to filter by if item is an assignment. No effect if 'type' is not 'assignment'.
exclude_submission_typesstring[]Submission types to exclude if item is an assignment. No effect if 'type' is not 'assignment'.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List communication messagesCANVAS_LIST_COMM_MESSAGESAcciónRetrieves communication messages from canvas.
CANVAS_LIST_COMM_MESSAGESAcciónRetrieves communication messages from canvas.
Parámetros de entrada
user_idstringIdentifier for the user whose messages are listed. Defaults to the authenticated user if omitted.
end_timestringEnd of the time filter (inclusive), as an ISO 8601 timestamp. Includes messages sent on or before this time.
start_timestringStart of the time filter (inclusive), as an ISO 8601 timestamp. Includes messages sent on or after this time.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List communication channelsCANVAS_LIST_COMMUNICATION_CHANNELSAcciónRetrieves a list of communication channels associated with a specific user in canvas.
CANVAS_LIST_COMMUNICATION_CHANNELSAcciónRetrieves a list of communication channels associated with a specific user in canvas.
Parámetros de entrada
user_idstringObligatorioThe ID of the user for whom to list communication channels. This can be the numeric ID or the SIS User ID.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List content exportsCANVAS_LIST_CONTENT_EXPORTSAcciónRetrieves a paginated list of content exports from canvas for a specified, existing course.
CANVAS_LIST_CONTENT_EXPORTSAcciónRetrieves a paginated list of content exports from canvas for a specified, existing course.
Parámetros de entrada
course_idstringObligatorioThe unique identifier for the course.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List coursesCANVAS_LIST_COURSESAcciónRetrieves a list of the current user's courses from canvas, optionally filtered by enrollment type and state.
CANVAS_LIST_COURSESAcciónRetrieves a list of the current user's courses from canvas, optionally filtered by enrollment type and state.
Parámetros de entrada
per_pageintegerNumber of courses to return per page. If omitted, Canvas default (10) is used. Set to a higher value (e.g., 100) to get more courses.
enrollment_typestringFilters courses by the user's enrollment type. If omitted, courses are not filtered by enrollment type.
enrollment_statestringFilters courses by the enrollment state. If omitted, courses are not filtered by enrollment state.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Courses for a UserCANVAS_LIST_COURSES_FOR_USERAcciónRetrieves a list of courses in canvas for a specified `user id`, requiring observer or admin permissions to view courses for others.
CANVAS_LIST_COURSES_FOR_USERAcciónRetrieves a list of courses in canvas for a specified `user id`, requiring observer or admin permissions to view courses for others.
Parámetros de entrada
statestring[]Filters courses by specified states (e.g., 'available', 'completed'). All allowed values are defined in the `validate_state` method.
includestring[]Specifies additional details to include for each course (e.g., 'syllabus_body', 'term'). All allowed values are defined in the `validate_include` method.
user_idintegerObligatorioThe unique identifier of the user for whom to retrieve the list of courses.
homeroombooleanIf true, filters the results to include only homeroom courses. Set to false or omit to include all course types.
account_idstringFilters the results to include only courses associated with the specified account ID.
enrollment_statestringFilters courses by the user's enrollment status (e.g., 'active'). All allowed values are defined in the `validate_enrollment_state` method.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Course UsersCANVAS_LIST_COURSE_USERSAcciónRetrieves a paginated list of users for a given canvas `course id` (which must be an existing course), supporting various filtering, sorting, and data inclusion options.
CANVAS_LIST_COURSE_USERSAcciónRetrieves a paginated list of users for a given canvas `course id` (which must be an existing course), supporting various filtering, sorting, and data inclusion options.
Parámetros de entrada
pageintegerPage number to fetch (1-indexed). Use to get results beyond the first page.
sortstringenumThe field to sort the list of users by. Results are sorted in ascending order.
usernamelast_loginemailsis_idincludestring[]Specifies additional details to include for each user in the response (e.g., 'enrollments', 'avatar_url').
user_idstringIf provided, the response will be paginated to the page where this specific user ID appears. Useful for finding a user within a large list.
per_pageintegerNumber of users to return per page (max 100). Higher values fetch more data in a single request.
user_idsinteger[]A list of user IDs to filter the results. Only users whose IDs are in this list will be returned.
course_idstringObligatorioThe unique identifier for the Canvas course from which to list users.
search_termstringA partial name or full ID to filter users. If provided, only users matching the search term will be returned.
enrollment_rolestringDeprecated: Filters users by a specific course-level role name. Use `enrollment_role_id` instead for better precision.
enrollment_typestring[]Filters the list to include only users with the specified enrollment types (e.g., 'student', 'teacher').
enrollment_statestring[]Filters the list to include only users with the specified enrollment states (e.g., 'active', 'invited').
enrollment_role_idintegerFilters the list to include only users enrolled with the specified course-level role ID.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Discussion EntriesCANVAS_LIST_DISCUSSION_ENTRIESAcciónTool to retrieve paginated discussion entries for a specific discussion topic in a course. use when needing to list all posts and replies under a given topic, supports pagination.
CANVAS_LIST_DISCUSSION_ENTRIESAcciónTool to retrieve paginated discussion entries for a specific discussion topic in a course. use when needing to list all posts and replies under a given topic, supports pagination.
Parámetros de entrada
pageintegerPage number to retrieve (pagination).
per_pageintegerNumber of entries to return per page (pagination).
topic_idintegerObligatorioThe unique identifier of the discussion topic.
course_idintegerObligatorioThe unique identifier of the course containing the discussion topic.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Discussion TopicsCANVAS_LIST_DISCUSSION_TOPICSAcciónRetrieves a paginated list of discussion topics or announcements for a specified course.
CANVAS_LIST_DISCUSSION_TOPICSAcciónRetrieves a paginated list of discussion topics or announcements for a specified course.
Parámetros de entrada
scopestringFilters topics by a specific state. Only one state can be specified. Valid options: 'locked', 'unlocked', 'pinned', 'unpinned'.
includestring[]Specifies additional data to return for each discussion topic. Valid options: 'all_dates', 'sections', 'sections_user_count', 'overrides'. Multiple options can be provided as a list of strings.
order_bystringThe criteria for ordering discussion topics. Defaults to 'position' if not specified. Valid options: 'position', 'recent_activity', 'title'.
course_idintegerObligatorioThe unique identifier of the course for which to list discussion topics.
filter_bystringFilters topics based on a characteristic, typically read status. Use 'unread' to get only unread topics. Valid options: 'all', 'unread'.
search_termstringA search string to match against discussion topic titles. Returns topics with partially matching titles.
only_announcementsbooleanIf true, retrieves only announcements; otherwise, retrieves discussion topics. Defaults to false.
exclude_context_module_locked_topicsbooleanIf true, and the requester is a student, excludes topics that are locked by module progression. Defaults to false.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List FilesCANVAS_LIST_FILESAcciónFetches metadata (id, name, size, type, urls) for all files within a specified canvas course.
CANVAS_LIST_FILESAcciónFetches metadata (id, name, size, type, urls) for all files within a specified canvas course.
Parámetros de entrada
course_idstringObligatorioThe unique Canvas identifier for the course whose files are to be listed.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List foldersCANVAS_LIST_FOLDERSAcciónRetrieves a list of immediate sub-folders within the specified `folder id`.
CANVAS_LIST_FOLDERSAcciónRetrieves a list of immediate sub-folders within the specified `folder id`.
Parámetros de entrada
folder_idstringObligatorioID of the parent folder for which to list direct sub-folders.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List pages for a courseCANVAS_LIST_PAGES_FOR_COURSEAcciónRetrieves a list of wiki pages associated with a specific, existing course in canvas.
CANVAS_LIST_PAGES_FOR_COURSEAcciónRetrieves a list of wiki pages associated with a specific, existing course in canvas.
Parámetros de entrada
sortstringThe field to sort the list of pages by. Common options include 'created_at', 'updated_at', or 'title'.
orderstringThe order in which to sort the results. Use 'asc' for ascending order or 'desc' for descending order.
course_idintegerObligatorioThe unique identifier for the course for which to list pages.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Quizzes in CourseCANVAS_LIST_QUIZZES_IN_COURSEAcciónRetrieves a paginated list of quizzes for a specified, valid canvas course, optionally filtering by a search term in the quiz title.
CANVAS_LIST_QUIZZES_IN_COURSEAcciónRetrieves a paginated list of quizzes for a specified, valid canvas course, optionally filtering by a search term in the quiz title.
Parámetros de entrada
pageintegerThe page number for paginated results, starting from 1. If not specified, the first page is returned.
per_pageintegerThe number of quizzes to return per page for paginated results. If not specified, a default number (e.g., 10) set by Canvas will be used.
course_idstringObligatorioThe unique identifier of the course from which to list quizzes.
search_termstringA partial title to filter quizzes. Only quizzes whose titles contain this term will be returned.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List sent content sharesCANVAS_LIST_SENT_CONTENT_SHARESAcciónRetrieves content shares sent by the specified user to other users or courses within canvas.
CANVAS_LIST_SENT_CONTENT_SHARESAcciónRetrieves content shares sent by the specified user to other users or courses within canvas.
Parámetros de entrada
user_idstringObligatorioThe unique identifier of the user whose sent content shares are to be retrieved. This can be the numeric Canvas user ID or a SIS ID prefixed with 'sis_user_id:'. Use 'self' to represent the currently authenticated user.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List submissionsCANVAS_LIST_SUBMISSIONSAcciónFetches gradebook history submissions for a specific course, assignment, grader, and date from canvas.
CANVAS_LIST_SUBMISSIONSAcciónFetches gradebook history submissions for a specific course, assignment, grader, and date from canvas.
Parámetros de entrada
datestringObligatorioThe specific date for which to retrieve submission history, in 'YYYY-MM-DD' format. This refers to the date the grading event occurred.
course_idintegerObligatorioThe unique identifier for the course.
grader_idintegerObligatorioThe unique identifier for the grader whose grading history is to be viewed.
assignment_idintegerObligatorioThe unique identifier for the assignment.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List submissions for multiple assignmentsCANVAS_LIST_SUBMISSIONSFOR_MULTIPLE_ASSIGNMENTSAcciónRetrieves submissions from a canvas course for specified assignments and/or students; the course must be accessible.
CANVAS_LIST_SUBMISSIONSFOR_MULTIPLE_ASSIGNMENTSAcciónRetrieves submissions from a canvas course for specified assignments and/or students; the course must be accessible.
Parámetros de entrada
course_idintegerObligatorioThe unique identifier for the Canvas course from which to retrieve submissions.
student_idsstring[]List of student identifiers to filter submissions. Accepts Canvas user IDs, SIS user IDs (e.g., 'sis_user_id:S123'), or the special keyword 'all'. If omitted, submissions for the current authenticated user are returned. Students can only retrieve their own submissions. Observers can only retrieve submissions for students they are associated with. The 'all' keyword retrieves submissions for all students in the specified course or section.
assignment_idsstring[]List of assignment identifiers (Canvas assignment IDs) for which to retrieve submissions. If this list is omitted or empty, submissions for all assignments in the course will be returned.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List uncollated submission versionsCANVAS_LIST_UNCOLLATED_SUBMISSION_VERSIONSAcciónRetrieves a feed of uncollated submission versions from the gradebook history for a course; any provided `assignment id` must be valid for the course, and any `user id` must be for a user enrolled in the course.
CANVAS_LIST_UNCOLLATED_SUBMISSION_VERSIONSAcciónRetrieves a feed of uncollated submission versions from the gradebook history for a course; any provided `assignment id` must be valid for the course, and any `user id` must be for a user enrolled in the course.
Parámetros de entrada
user_idintegerID of the user (student) to filter submission versions.
ascendingbooleanIf true, returns submission versions in ascending order by date (oldest first); defaults to descending (newest first).
course_idintegerObligatorioID of an existing course to fetch submission versions from.
assignment_idintegerID of the assignment to filter submission versions.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List users in accountCANVAS_LIST_USERS_IN_ACCOUNTAcciónUse this action to retrieve all users associated with a specific, existing canvas account id.
CANVAS_LIST_USERS_IN_ACCOUNTAcciónUse this action to retrieve all users associated with a specific, existing canvas account id.
Parámetros de entrada
account_idintegerObligatorioThe unique identifier of the Canvas account from which to retrieve the list of users.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Reply to discussion entryCANVAS_REPLY_TO_DISCUSSION_ENTRYAcciónTool to reply to a discussion entry. use when you need to send a message to a discussion entry with optional attachments.
CANVAS_REPLY_TO_DISCUSSION_ENTRYAcciónTool to reply to a discussion entry. use when you need to send a message to a discussion entry with optional attachments.
Parámetros de entrada
messagestringObligatorioThe body content of the reply to create. Supports HTML formatting.
entry_idintegerObligatorioThe unique identifier for the discussion entry to which the reply will be posted.
topic_idintegerObligatorioThe unique identifier for the discussion topic within the course.
course_idintegerObligatorioThe unique identifier for the Canvas course containing the discussion topic.
attachment_idsinteger[]A list of file attachment IDs to include with the reply, if any.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve enrollment termCANVAS_RETRIEVE_ENROLLMENT_TERMAcciónRetrieves detailed information for a specific enrollment term within a given root account in canvas.
CANVAS_RETRIEVE_ENROLLMENT_TERMAcciónRetrieves detailed information for a specific enrollment term within a given root account in canvas.
Parámetros de entrada
term_idstringObligatorioThe unique identifier of the enrollment term to be retrieved from the specified account.
account_idstringObligatorioThe unique identifier for the root account. Important: This must be the ID of a root-level account, not a sub-account, to avoid errors.
Parámetros de salida
dataobjectA dictionary containing the detailed information of the retrieved enrollment term.
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Start a ReportCANVAS_START_REPORTAcciónInitiates an asynchronous report generation for a canvas account, using a valid report type for the account; the response confirms initiation and may include progress tracking details.
CANVAS_START_REPORTAcciónInitiates an asynchronous report generation for a canvas account, using a valid report type for the account; the response confirms initiation and may include progress tracking details.
Parámetros de entrada
reportstringObligatorioThe type or name of the report to start. Use the 'List Available Reports' action or Canvas API documentation to get available report types.
account_idintegerObligatorioThe unique identifier for the Canvas account for which the report will be generated.
parametersobjectParameters specific to the chosen report type (e.g., a 'grade_export_csv' might need `courses[course_id]`). Consult 'List Available Reports' or API documentation for parameter details. Omit if none are needed.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Translate File ReferenceCANVAS_TRANSLATE_FILE_REFERENCEAcciónResolves a file's migration id to its current representation within a specific canvas course.
CANVAS_TRANSLATE_FILE_REFERENCEAcciónResolves a file's migration id to its current representation within a specific canvas course.
Parámetros de entrada
course_idstringObligatorioIdentifier for the Canvas course containing the file.
migration_idstringObligatorioIdentifier for a file reference, typically assigned during content import, used to find its current representation in the course.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update Appointment GroupCANVAS_UPDATE_APPOINTMENT_GROUPAcciónUpdates an existing canvas appointment group by its id; only provided fields are modified, but `publish` defaults to `false` if omitted. the `appointment group id` must be valid.
CANVAS_UPDATE_APPOINTMENT_GROUPAcciónUpdates an existing canvas appointment group by its id; only provided fields are modified, but `publish` defaults to `false` if omitted. the `appointment group id` must be valid.
Parámetros de entrada
titlestringShort title. Omit to keep existing.
publishbooleanSet `True` to publish; `False` for draft. Defaults to `False` if omitted.
descriptionstringDetailed description. Omit to keep existing.
context_codesstring[]Codes (e.g., 'course_123') linking to contexts like courses/groups. Omit to keep existing.
location_namestringLocation name (e.g., 'Room 301', 'Online Zoom'). Omit to keep existing.
location_addressstringPhysical/virtual address for location. Omit to keep existing.
sub_context_codesstring[]Codes (e.g., 'section_abc') for sub-contexts like course sections. Omit to keep existing.
appointment_group_idstringObligatorioUnique identifier of the appointment group to update.
allow_observer_signupboolean`True` allows observer sign-ups, `False` disallows. Omit to keep existing.
participant_visibilitystringenumParticipant list visibility ('private' or 'protected'). Omit to keep existing.
privateprotectedparticipants_per_appointmentintegerMax participants per slot. Omit to keep existing.
max_appointments_per_participantintegerMax slots a user may book. Omit to keep existing.
min_appointments_per_participantintegerMin slots a user must book. Omit to keep existing.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update courseCANVAS_UPDATE_COURSEAcciónUpdates an existing course, specified by its id, with new attributes or triggers a lifecycle event like 'conclude' or 'delete'.
CANVAS_UPDATE_COURSEAcciónUpdates an existing course, specified by its id, with new attributes or triggers a lifecycle event like 'conclude' or 'delete'.
Parámetros de entrada
idstringObligatorioThe ID of the course to update.
namestringNew name for the course.
eventstringenumLifecycle action for the course (e.g., 'conclude', 'offer', 'delete').
claimofferconcludedeleteundeleteend_atstringdate-timeNew end date in ISO8601 format.
licensestringenumNew license for course content, defining usage.
privatecc_by_nc_ndcc_by_nc_sacc_by_nccc_by_ndcc_by_sacc_bypublic_domainterm_idintegerID of the academic term to associate with the course.
start_atstringdate-timeNew start date in ISO8601 format.
is_publicbooleanIf `true`, course is visible to all users (authenticated and unauthenticated).
account_idintegerThe ID of the account to which the course will be reassigned.
course_codestringNew course code.
default_viewstringenumDefault landing page view when users navigate to the course.
feedwikimodulessyllabusassignmentssyllabus_bodystringHTML content for the course syllabus, replacing existing content.
open_enrollmentbooleanIf `true`, allows open enrollment where users can self-enroll without approval.
public_syllabusbooleanIf `true`, syllabus is publicly visible to everyone.
self_enrollmentbooleanIf `true`, allows users to self-enroll, often via a URL or code.
public_descriptionstringPublicly visible description of course content or objectives.
allow_wiki_commentsbooleanIf `true`, course members can add comments to wiki pages.
is_public_to_auth_usersbooleanIf `true`, course is visible only to authenticated users.
override_sis_stickinessbooleanIf `true`, API updates can override SIS-controlled fields; if `false`, updates to 'sticky' SIS fields are prevented.
public_syllabus_to_authbooleanIf `true`, syllabus is visible only to authenticated users.
allow_student_wiki_editsbooleanIf `true`, enrolled students can edit wiki pages.
allow_student_forum_attachmentsbooleanIf `true`, students can attach files to forum posts.
restrict_enrollments_to_course_datesbooleanIf `true`, enrollment is restricted to the course's start and end dates.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update course settingsCANVAS_UPDATE_COURSE_SETTINGSAcciónUpdates various settings for an existing course in canvas, identified by `course id`.
CANVAS_UPDATE_COURSE_SETTINGSAcciónUpdates various settings for an existing course in canvas, identified by `course id`.
Parámetros de entrada
course_idintegerObligatorioThe unique identifier for the course whose settings are to be updated.
default_due_timestringSets the default due time for new assignments. This time will be pre-selected in the Canvas UI. Does not affect existing assignments. Format: HH:MM:SS (24-hour). Default is '23:59:59'. Use 'inherit' to use the account-level setting.
hide_final_gradesbooleanIf true, hides the total grades in the student grades summary page.
conditional_releasebooleanIf true, enables individual learning paths for students, allowing content to be released based on their performance on assessments or other criteria.
usage_rights_requiredbooleanIf true, requires copyright and license information to be provided for files before they can be published.
lock_all_announcementsbooleanIf true, disables comments on all course announcements.
syllabus_course_summarybooleanIf true (default), shows the course summary, including a list of assignments and calendar events, on the syllabus page.
hide_distribution_graphsbooleanIf true, hides grade distribution graphs from students' view.
allow_final_grade_overridebooleanIf true, allows instructors to override the final grade for students for a grading period or the entire course.
restrict_student_past_viewbooleanIf true, restricts students from viewing the course content after the official course end date.
home_page_announcement_limitintegerSpecifies the maximum number of announcements to display on the home page when `show_announcements_on_home_page` is enabled. Only applicable if the home page is a Wiki.
restrict_student_future_viewbooleanIf true, restricts students from viewing the course content before the official course start date.
allow_student_organized_groupsbooleanIf true, allows students to create and manage their own groups within the course.
allow_student_discussion_topicsbooleanIf true, allows students to create new discussion topics.
allow_student_forum_attachmentsbooleanIf true, allows students to attach files to their discussion posts and replies.
show_announcements_on_home_pagebooleanIf true, displays the most recent course announcements on the course home page. For Wiki home pages, this defaults to five announcements but can be configured via `home_page_announcement_limit`. This setting is ignored by Canvas for Elementary subjects.
allow_student_discussion_editingbooleanIf true, allows students to edit or delete their own discussion posts and replies.
allow_student_discussion_reportingbooleanIf true, allows students to report discussion content they deem offensive or inappropriate.
hide_sections_on_course_users_pagebooleanIf true, prevents students from viewing other students in sections they are not enrolled in on the course users page.
filter_speed_grader_by_student_groupbooleanIf true, SpeedGrader will be filtered to display students only from the currently selected group.
allow_student_anonymous_discussion_topicsbooleanIf true, allows students to create discussion topics anonymously.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update fileCANVAS_UPDATE_FILEAcciónModifies an existing file's name or relocates it to a new parent folder; the target folder, if specified, must be valid and in the file's original context.
CANVAS_UPDATE_FILEAcciónModifies an existing file's name or relocates it to a new parent folder; the target folder, if specified, must be valid and in the file's original context.
Parámetros de entrada
namestringThe new display name for the file. If this field is not provided or is null, the file's current name will be preserved.
file_idstringObligatorioThe unique identifier of the file to be updated.
on_duplicatestringDefines the action to take if a file with the specified `name` already exists in the target `parent_folder_id`. Valid options are: 'rename' (the uploaded file will be renamed to avoid conflict, e.g., 'filename (1).txt') or 'overwrite' (the existing file will be replaced). If not provided or null, the Canvas API's default behavior for handling duplicates will apply.
parent_folder_idstringID of the folder to move the file to. Must be an existing folder in the same context as the file's original parent. Ignored if the context lacks folders (e.g., root user files) or if null (file stays in current location).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update page for a courseCANVAS_UPDATE_PAGE_FOR_COURSEAcciónUpdates an existing wiki page in a canvas course; if setting as front page, it must also be or be made published.
CANVAS_UPDATE_PAGE_FOR_COURSEAcciónUpdates an existing wiki page in a canvas course; if setting as front page, it must also be or be made published.
Parámetros de entrada
bodystringNew HTML content for the page body. Retains existing if None.
titlestringNew title for the page. Retains existing if None.
course_idstringObligatorioIdentifier of the course containing the page.
publishedbooleanPublish or unpublish the page. Retains existing status if None.
url_or_idstringObligatorioURL (hyphenated string from title) or numeric ID of the page to update.
front_pagebooleanSet as course front page (must be published). Retains existing status if None.
editing_rolesstringComma-separated list of roles ('teachers', 'students', 'members', 'public') allowed to edit. Retains existing if None.
notify_of_updatebooleanNotify course participants of the update. Retains existing preference if None.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update quiz submission scoresCANVAS_UPDATE_QUIZ_SUBMISSION_SCORESAcciónUpdates scores, comments for questions, and/or applies fudge points to a specific quiz submission attempt; the attempt must be completed and referenced by valid, existing course, quiz, and submission ids.
CANVAS_UPDATE_QUIZ_SUBMISSION_SCORESAcciónUpdates scores, comments for questions, and/or applies fudge points to a specific quiz submission attempt; the attempt must be completed and referenced by valid, existing course, quiz, and submission ids.
Parámetros de entrada
idstringObligatorioThe unique identifier for the quiz submission to be updated.
attemptintegerObligatorioThe specific attempt number of the quiz submission to update. The attempt must have been completed before scores can be updated.
quiz_idstringObligatorioThe unique identifier for the quiz to which the submission belongs.
course_idstringObligatorioThe unique identifier for the course to which the quiz submission belongs.
questionsobjectScores and comments for individual questions. Keys are question identifiers; values are objects detailing 'score' (float) and 'comment' (string) for feedback, enabling detailed per-question grading.
fudge_pointsnumberA numerical value (positive or negative) used to manually adjust the total score of the quiz submission. This can be used for applying discretionary bonuses or penalties.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update User SettingsCANVAS_UPDATE_USER_SETTINGSAcciónUpdates a canvas user's preferences for various interface elements and content interaction behaviors.
CANVAS_UPDATE_USER_SETTINGSAcciónUpdates a canvas user's preferences for various interface elements and content interaction behaviors.
Parámetros de entrada
user_idintegerObligatorioThe unique identifier of the user whose settings are to be updated.
collapse_course_navbooleanIf `true`, course navigation menus will load collapsed by default.
collapse_global_navbooleanIf `true`, the global navigation menu will load collapsed by default.
manual_mark_as_readbooleanIf `true`, user must manually mark discussion posts as read; `false` means posts are marked read automatically upon viewing.
hide_dashcard_color_overlaysbooleanIf `true`, color overlays on dashboard course card images will be hidden.
release_notes_badge_disabledbooleanIf `true`, the badge indicating new release notes will be hidden.
elementary_dashboard_disabledbooleanIf `true`, the classic Canvas dashboard view is displayed; `false` displays the Canvas for Elementary view.
comment_library_suggestions_enabledbooleanIf `true`, suggestions from the comment library will be displayed when commenting.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Upload a course fileCANVAS_UPLOAD_COURSE_FILEAcciónUploads a file to an accessible canvas course, optionally to a specific folder (created if a non-existent `parent folder path` is provided) and with defined behavior for duplicate filenames.
CANVAS_UPLOAD_COURSE_FILEAcciónUploads a file to an accessible canvas course, optionally to a specific folder (created if a non-existent `parent folder path` is provided) and with defined behavior for duplicate filenames.
Parámetros de entrada
fileobjectObligatorioFile containing its name and readable content buffer.
course_idstringObligatorioUnique identifier of the accessible Canvas course.
on_duplicatestringAction for duplicate filenames: 'overwrite' or 'rename'. If unspecified, Canvas's default behavior applies.
parent_folder_idintegerUnique ID of the target folder. If omitted, uploads to the course's root folder. Mutually exclusive with `parent_folder_path`.
parent_folder_pathstringFull path to the target folder (e.g., 'course_materials/week1'). If omitted, uploads to the course's root folder. Mutually exclusive with `parent_folder_id`.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Upload submission fileCANVAS_UPLOAD_SUBMISSION_FILEAcciónUploads a submission file for an assignment in a canvas course for a specified `user id`; this user must be enrolled, the assignment open for them, and 'masquerade' permissions may be needed if `user id` isn't 'self'.
CANVAS_UPLOAD_SUBMISSION_FILEAcciónUploads a submission file for an assignment in a canvas course for a specified `user id`; this user must be enrolled, the assignment open for them, and 'masquerade' permissions may be needed if `user id` isn't 'self'.
Parámetros de entrada
fileobjectObligatorioThe file to upload as the submission.
user_idstringObligatorioIdentifier of the user (e.g., student) making the submission; use 'self' for the currently authenticated user.
course_idstringObligatorioIdentifier of the course containing the assignment.
assignment_idstringObligatorioIdentifier of the assignment for the submission.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Triggers (6)
Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).
Canvas Assignment GradedCANVAS_ASSIGNMENT_GRADED_TRIGGERTriggerPolls Canvas for newly graded submissions for a specific assignment.
CANVAS_ASSIGNMENT_GRADED_TRIGGERTriggerPolls Canvas for newly graded submissions for a specific assignment.
Configuración
assignment_idintegerObligatorioThe ID of the assignment to monitor for grading activity.
course_idintegerObligatorioThe ID of the Canvas course containing the assignment.
intervalnumberPeriodic Interval to Check for Updates & Send a Trigger in Minutes
Payload del evento
canvas_user_idintegerObligatorioThe ID of the Canvas user who submitted the assignment.
gradestringThe grade for the submission.
is_gradedbooleanObligatorioWhether the submission has been graded.
Instrucciones
**Instructions for Setting Up the Trigger:** 1. Provide the course ID - this can be found in the URL when viewing the course in Canvas. For example, in "https://canvas.instructure.com/courses/12345", the course ID is 12345. 2. Provide the assignment ID - this can be found in the URL when viewing the assignment. For example, in "https://canvas.instructure.com/courses/12345/assignments/67890", the assignment ID is 67890.
New Canvas Assignment SubmissionCANVAS_NEW_ASSIGNMENT_SUBMISSION_TRIGGERTriggerPolls Canvas for new submissions to a specific assignment.
CANVAS_NEW_ASSIGNMENT_SUBMISSION_TRIGGERTriggerPolls Canvas for new submissions to a specific assignment.
Configuración
assignment_idintegerObligatorioThe ID of the assignment to monitor for new submissions.
course_idintegerObligatorioThe ID of the Canvas course containing the assignment.
intervalnumberPeriodic Interval to Check for Updates & Send a Trigger in Minutes
Payload del evento
canvas_user_idintegerObligatorioThe ID of the Canvas user who submitted the assignment.
gradestringThe grade, if graded.
idintegerObligatorioThe ID of the submission.
latebooleanObligatorioWhether the submission was late.
preview_urlstringObligatorioURL to preview the submission.
submission_typestringThe type of submission (online_text_entry, online_upload, etc).
submitted_atstringWhen the submission was made.
workflow_statestringObligatorioThe state of the submission (submitted, unsubmitted, graded, etc).
Instrucciones
**Instructions for Setting Up the Trigger:** 1. Provide the course ID - this can be found in the URL when viewing the course in Canvas. For example, in "https://canvas.instructure.com/courses/12345", the course ID is 12345. 2. Provide the assignment ID - this can be found in the URL when viewing the assignment. For example, in "https://canvas.instructure.com/courses/12345/assignments/67890", the assignment ID is 67890. 3. This trigger will fire whenever a new submission is made to the specified assignment.
New Canvas Discussion MessageCANVAS_NEW_CANVAS_DISCUSSION_MESSAGE_TRIGGERTriggerPolls Canvas discussion topics for new messages.
CANVAS_NEW_CANVAS_DISCUSSION_MESSAGE_TRIGGERTriggerPolls Canvas discussion topics for new messages.
Configuración
course_idintegerObligatorioThe ID of the Canvas course containing the discussion.
intervalnumberPeriodic Interval to Check for Updates & Send a Trigger in Minutes
topic_idsanyObligatorioThe IDs of the discussion topics to monitor for new messages.
Payload del evento
canvas_user_idintegerCanvas user ID of the entry author.
course_idintegerObligatorioThe course ID the discussion belongs to.
created_atstringWhen the entry was created.
idintegerObligatorioThe ID of the discussion entry.
messagestringThe content of the discussion entry.
parent_idintegerParent entry ID if this is a reply.
raw_entryobjectThe raw API response for this entry.
topic_idintegerObligatorioThe discussion topic ID this entry belongs to.
updated_atstringWhen the entry was last updated.
user_namestringThe name of the user who posted the entry.
Instrucciones
**Instructions for Setting Up the Trigger:** 1. Provide the course ID - this can be found in the URL when viewing the course in Canvas. For example, in "https://canvas.instructure.com/courses/12345", the course ID is 12345. 2. Provide the discussion topic IDs - comma-separated list. Each can be found in the URL when viewing the discussion topic. For example, in "https://canvas.instructure.com/courses/12345/discussion_topics/67890", the topic ID is 67890. 3. This trigger will fire whenever new messages are posted to any of the specified discussion topics.
New Canvas Discussion TopicCANVAS_NEW_CANVAS_DISCUSSION_TRIGGERTriggerPolls a Canvas course for new discussion topics.
CANVAS_NEW_CANVAS_DISCUSSION_TRIGGERTriggerPolls a Canvas course for new discussion topics.
Configuración
course_idintegerObligatorioThe ID of the Canvas course to monitor for new discussion topics.
filter_bystringThe state of the discussion topics to return. Options: 'all', 'unread'.
includestring[]Additional fields to include. Options: 'all_dates', 'sections', 'sections_user_count', 'overrides'
intervalnumberPeriodic Interval to Check for Updates & Send a Trigger in Minutes
order_bystringDetermines the order of the discussion topic list. Options: 'position', 'recent_activity', 'title'.
Payload del evento
event_typestringType of discussion event
topicobjectObligatorioThe discussion topic that was created
Instrucciones
**Instructions for Setting Up the Trigger:** 1. Provide the course ID - this can be found in the URL when viewing the course in Canvas. For example, in "https://canvas.instructure.com/courses/12345", the course ID is 12345. 2. Optionally configure additional parameters: - Include additional fields like 'all_dates', 'sections', etc. - Change the ordering of discussions (defaults to 'recent_activity' for optimal detection) - Filter discussions by state ('all' or 'unread') 3. On first poll, the trigger will establish a baseline and won't trigger for existing discussions. 4. Subsequent polls will identify and trigger only for genuinely new discussions.
New Course Created for UserCANVAS_NEW_COURSE_CREATED_TRIGGERTriggerPolls Canvas for newly created courses for a specific user.
CANVAS_NEW_COURSE_CREATED_TRIGGERTriggerPolls Canvas for newly created courses for a specific user.
Configuración
intervalnumberPeriodic Interval to Check for Updates & Send a Trigger in Minutes
user_idintegerObligatorioThe ID of the user to monitor courses for.
Payload del evento
account_idintegerThe account ID the course belongs to.
course_codestringThe course code.
created_atstringWhen the course was created.
end_atstringWhen the course ends.
enrollment_term_idintegerThe term ID for this course.
idintegerObligatorioThe ID of the course.
namestringObligatorioThe name of the course.
start_atstringWhen the course starts.
time_zonestringThe time zone of the course.
workflow_statestringThe state of the course.
Instrucciones
**Instructions for Setting Up the Trigger:** 1. Provide the user ID to monitor courses for. This can be found in the Canvas user profile URL. For example, in "https://canvas.instructure.com/users/12345", the user ID is 12345. 2. This trigger will fire whenever a new course is created or the user is enrolled in a new course.
New Canvas File UploadCANVAS_NEW_FILE_UPLOADED_TRIGGERTriggerPolls a Canvas course for new file uploads.
CANVAS_NEW_FILE_UPLOADED_TRIGGERTriggerPolls a Canvas course for new file uploads.
Configuración
course_idintegerObligatorioThe ID of the Canvas course to monitor for new file uploads.
intervalnumberPeriodic Interval to Check for Updates & Send a Trigger in Minutes
Payload del evento
new_filesobject[]ObligatorioThe new files uploaded to Canvas.
Instrucciones
**Instructions for Setting Up the Trigger:** 1. Provide the course ID - this can be found in the URL when viewing the course in Canvas. For example, in "https://canvas.instructure.com/courses/12345", the course ID is 12345. 2. The trigger will fire whenever new files are uploaded to the course.