list_submissions
Read-only
Retrieve all submissions for a Canvas assignment. Filter by student ids, workflow state, or grading period; include comments, history, rubric, or user data.
Instructions
List all submissions for an assignment. Use include to attach user, assignment, rubric_assessment, submission_history, or visibility. Filter with student_ids, workflow_state, or grading_period_id. Defaults to including submission_comments.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| course_id | Yes | The Canvas course ID | |
| assignment_id | Yes | The Canvas assignment ID | |
| include | No | Extra fields to include (Canvas include[] param). Defaults to ["submission_comments"] when omitted. | |
| student_ids | No | Restrict to submissions for these user IDs. Use "all" or "self" for shortcuts. | |
| section_ids | No | Restrict to submissions in these sections | |
| grouped | No | Return one submission per group rather than per student | |
| workflow_state | No | Only include submissions in this workflow state | |
| grading_period_id | No | Restrict to a grading period |