canvas files set-usage-rights
canvas files set-usage-rights¶
Set copyright and license information on files
Synopsis¶
Set copyright and license information for one or more files.
use-justification values: own_copyright, used_by_permission, fair_use, public_domain, creative_commons (license required when using creative_commons).
Examples:
canvas files set-usage-rights --course-id 123 --file-ids 1,2,3 --use-justification own_copyright
canvas files set-usage-rights --group-id 456 --file-ids 5 --use-justification creative_commons --license cc_by
Options¶
--course-id int Course ID
--file-ids int64Slice File IDs (comma-separated) (default [])
--folder-ids int64Slice Folder IDs to apply rights to all files within (default [])
--group-id int Group ID
-h, --help help for set-usage-rights
--legal-copyright string Legal copyright line
--license string License (required for creative_commons)
--publish Publish the files after setting rights
--use-justification string Use justification (required)
--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")
--quiet Suppress informational messages, only output data and errors
--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¶
- canvas files - Manage Canvas files