Skip to content
proton-cli
Menu
DocsCommandsFAQStats
Start here
InstallFirst commandsHow a command is builtManaging proton itself
Everyday use
Naming what to act onFilters and bulk changesDry runs and confirmationsOutput and exit codesScriptingAI agentsSettings, files and environment
When something goes wrong
TroubleshootingWhat it can't do
Account
Guideproton accountproton account keysproton account sessionsproton account security-logproton account breachesproton account profilesproton account settings
Mail
Guideproton mail messagesproton mail conversationsproton mail draftsproton mail mailing-listsproton mail protectedproton mail settings
Drive
Guideproton drive itemsproton drive trashproton drive photosproton drive computersproton drive sharingproton drive linksproton drive sharedproton drive invitationsproton drive settingsproton drive volumes
Calendar
Guideproton calendar eventsproton calendar busy-timesproton calendar booking-pagesproton calendar remindersproton calendar invitationsproton calendar settings
Pass
Guideproton pass itemsproton pass vaultsproton pass aliasesproton pass linksproton pass sharingproton pass sharedproton pass invitationsproton pass trashproton pass breachesproton pass settingsimport, export, generate
Contacts
Guideproton contactsproton contacts emailsproton contacts groupsproton contacts keys
Local index
Guideproton index
Raw API
Guideproton api
About
FAQSecurityAll commandsChangelogProton API reference

proton drive shared

Files and folders other people have shared with you.

Every command under proton drive shared, with the arguments and flags it takes. For these commands in use, see the drive guide.

Holds add, leave, list and remove.

add

Section titled “add”

Add a public link to what is shared with you.

URL is the link as it was sent to you, including everything after the #. Once added it appears in shared list and opens with --shared REF, with nothing to pass again. A link with a password takes it from –link-password-file, which takes - for stdin, and keeps it.

proton drive shared add URL
Terminal window
proton drive shared add 'https://drive.proton.me/urls/7X2K9M3N1P#kQ81mDx4T9wL'
proton drive shared add 'https://drive.proton.me/urls/7X2K9M3N1P#kQ81mDx4T9wL' --link-password-file /run/secrets/q3-link
Flag Description
--link-password-file string Read the public link’s password from a file, or - for stdin

leave

Section titled “leave”

Give up an item somebody shared with you.

Only a new invitation from whoever shared it brings it back, so this asks first. To take a public link you saved out of the listing, use shared remove.

proton drive shared leave REF...
Terminal window
proton drive shared leave Project
proton drive shared leave Project --yes

list

Section titled “list”

List what other people have shared with you.

Items shared with you directly and public links you saved with shared add are listed together. A saved link shows public link under SHARED BY, and ROLE is what you may do: a viewer lists and downloads, an editor uploads as well.

These are not in your tree and have no path of their own. To open one, pass --shared REF to any items command: / is then the item itself, and anything below it is a path inside it. In a saved link, what you uploaded yourself is yours to rename or delete for an hour; nothing else in it can be changed from here.

An item whose name cannot be decrypted is still listed and can be acted on by ID.

proton drive shared list
Terminal window
proton drive shared list
Flag Description
--desc Reverse the order
--limit int How many items per page; 0 for all of them
--page int Which page of results, counting from zero
--sort string Order by: name, size, shared (default name)

remove

Section titled “remove”

Forget a public link you saved.

The link itself keeps working, and shared add brings it back. To give up an item somebody shared with you directly, use shared leave.

proton drive shared remove REF...
Terminal window
proton drive shared remove Q3-report.pdf

Every command also takes the flags that work everywhere.