Skip to content

canvas files upload

canvas files upload

Upload a file

Synopsis

Upload a file to a course, folder, or user's files.

You must specify one of --course-id, --folder-id, or --user-id.

Examples:

canvas files upload document.pdf --course-id 123
canvas files upload image.png --folder-id 456
canvas files upload data.csv --user-id 789
canvas files upload file.pdf --course-id 123 --on-duplicate overwrite
canvas files upload <file-path> [flags]

Options

      --course-id int         Course ID
      --folder-id int         Folder ID
  -h, --help                  help for upload
      --hidden                Hide from students
      --locked                Lock the file
      --on-duplicate string   How to handle duplicates (overwrite, rename) (default "rename")
      --parent-folder int     Parent folder ID
      --user-id int           User ID

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