Commands
file share
Share a file publicly, privately, or with specific users.
poly file share manages sharing for a file. Sharing is online-only — it requires connectivity to the server and doesn't work with --cache-only.
Usage
poly file share <TARGET>
TARGET accepts a local path inside the sync folder, a //-prefixed Poly path, a deep link, or a web URL — see How it Works for the full reference syntax. Run with no mode flag to make the file public and print a summary and link.
Flags
| Flag | Description |
|---|---|
--url | Print only the bare share URL. |
--with <email|user-id> | Invite or update a specific user's access. |
--remove | Revoke access. Requires --with. |
--make-public | Make the file public. |
--make-private | Make the file private. |
--role <viewer|editor|admin> | Role to grant. Used with --with; public modes only allow viewer or editor. Defaults to viewer. |
Examples
# Make a file public and print the summary and link
poly file share //Home/docs/report.pdf
# Print just the share URL
poly file share //Home/docs/report.pdf --url
# Share with a specific user as an editor
poly file share //Home/docs/report.pdf --with [email protected] --role editor
# Revoke a user's access
poly file share //Home/docs/report.pdf --with [email protected] --remove
# Make a public file public-editor instead of public-viewer
poly file share //Home/docs/report.pdf --make-public --role editor
# Make a file private again
poly file share //Home/docs/report.pdf --make-private