Skip to content

canvas outcomes create

canvas outcomes create

Create a new outcome

Synopsis

Create a new learning outcome in an outcome group.

Outcomes must be created within an outcome group. Use --group-id to specify the target group, which can be the root group or any subgroup.

Calculation methods: - decaying_average: Weighted average favoring recent scores - n_mastery: Latest N scores must meet mastery threshold - latest: Only the most recent score counts - highest: Use the highest score achieved

Examples:

canvas outcomes create --course-id 123 --group-id 456 --title "Problem Solving"
canvas outcomes create --account-id 1 --group-id 789 --title "Critical Thinking" --mastery-points 4
canvas outcomes create --course-id 123 --group-id 456 --title "Writing" --calculation-method decaying_average --calculation-int 65
canvas outcomes create [flags]

Options

      --account-id int              Account ID
      --calculation-int int         Calculation parameter
      --calculation-method string   Calculation method (decaying_average, n_mastery, latest, highest)
      --course-id int               Course ID
      --description string          Description
      --display-name string         Display name
      --group-id int                Outcome group ID (required)
  -h, --help                        help for create
      --mastery-points float        Points for mastery
      --title string                Outcome title (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