Skip to content

canvas submissions grade

canvas submissions grade

Grade a submission

Synopsis

Grade a specific submission for an assignment and user.

You can provide a score, comment, or excuse the submission.

Examples:

canvas submissions grade --course-id 123 --assignment-id 456 --user-id 789 --score 95
canvas submissions grade --course-id 123 --assignment-id 456 --user-id 789 --score 85 --comment "Good work"
canvas submissions grade --course-id 123 --assignment-id 456 --user-id 789 --excuse
canvas submissions grade [flags]

Options

      --assignment-id int     Assignment ID (required)
      --comment string        Comment to add
      --course-id int         Course ID (required)
      --excuse                Excuse the submission
  -h, --help                  help for grade
      --posted-grade string   Posted grade (e.g., 'A', 'B+', 'Pass')
      --score float           Score to assign
      --user-id int           User ID (required)

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)
      --dry-run           Print curl commands instead of executing requests
      --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