Skip to content

canvas discussions create

canvas discussions create

Create a new discussion topic

Synopsis

Create a new discussion topic in a course.

Examples:

canvas discussions create --course-id 123 --title "Week 1 Discussion"
canvas discussions create --course-id 123 --title "Q&A" --message "<p>Ask questions here</p>" --type threaded
canvas discussions create --course-id 123 --title "Pinned" --pinned --published
canvas discussions create [flags]

Options

      --allow-rating             Allow rating of entries
      --course-id int            Course ID (required)
      --delayed-post-at string   Delay posting until (ISO 8601)
  -h, --help                     help for create
      --lock-at string           Lock at date (ISO 8601)
      --message string           Discussion message (HTML)
      --pinned                   Pin the discussion
      --published                Publish the discussion
      --require-initial-post     Require initial post before viewing
      --title string             Discussion title (required)
      --type string              Discussion type: side_comment, threaded, not_threaded

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