Skip to content

canvas submissions bulk-grade

canvas submissions bulk-grade

Grade multiple submissions from CSV

Synopsis

Grade multiple submissions at once by importing grades from a CSV file.

The CSV file should have the following format: user_id,assignment_id,score,comment

Example CSV: 123,456,95,"Excellent work" 124,456,87,"Good job" 125,456,92,"Great effort"

Examples:

canvas submissions bulk-grade --course-id 123 --csv grades.csv
canvas submissions bulk-grade --course-id 123 --csv grades.csv --dry-run
canvas submissions bulk-grade [flags]

Options

      --course-id int   Course ID (required)
      --csv string      CSV file with grades (required)
      --dry-run         Preview changes without applying them
  -h, --help            help for bulk-grade

Options inherited from parent commands

      --as-user int       Masquerade as another user (admin feature, requires permission)
      --columns strings   Select specific columns to display (comma-separated)
      --config string     config file (default is $HOME/.canvas-cli/config.yaml)
      --filter string     Filter results by text (case-insensitive substring match)
      --instance string   Canvas instance URL (overrides config)
      --limit int         Limit number of results for list operations (0 = unlimited)
      --no-cache          Disable caching of API responses
  -o, --output string     Output format: table, json, yaml, csv (default "table")
      --show-token        Show actual token in dry-run output (default: redacted)
      --sort string       Sort results by field (prefix with - for descending, e.g., -name)
  -v, --verbose           Enable verbose output

SEE ALSO

Auto generated by spf13/cobra on 25-Jan-2026