maton one-drive item invite
maton one-drive item invite <item-id> [flags]
Grant access to a drive item for one or more email recipients. –emails accepts a comma-separated list. –roles is a comma-separated list of “read” and/or “write” (default “read”). When –send-invitation is true (the default) an email is sent to each recipient.
Options
-
--connection <string> - Connection ID to route through (Maton-Connection header)
-
--dry-run - Print the request that would be sent without executing it
-
--emails <string> - Comma-separated recipient emails (required)
-q,--jq <expression>- Filter JSON output using a jq expression
-
--json - Output raw JSON
-
--message <string> - Optional message included in the invitation email
-
--paginate - Follow next_cursor and concatenate all pages (list commands only)
-
--require-sign-in (default true) - Recipients must sign in to access the item
-
--roles <string> (default "read") - Comma-separated roles: read, write
-
--send-invitation (default true) - Send an email notification to each recipient
-t,--template <string>- Format JSON output using a Go template; see "maton help formatting"
Options inherited from parent commands
-p,--profile <string>- Profile to use for this invocation (overrides the active profile; also reads MATON_PROFILE)
Examples
$ maton one-drive item invite 01ABCDEF --emails alice@example.com
$ maton one-drive item invite 01ABCDEF --emails alice@example.com,bob@example.com --roles write
$ maton one-drive item invite 01ABCDEF --emails alice@example.com --message 'Have a look' --require-sign-in=false