Commands
mkdrive
Create a shared drive in Poly.
poly mkdrive creates a new shared drive. Every shared drive gets its own home and archive folder, just like your personal drive.
Usage
poly mkdrive <NAME>
A handle for the drive's /shared/<handle> link is generated randomly. See Shared Drives for how drives and membership work.
Flags
| Flag | Description |
|---|---|
--notes <TEXT> | Attach notes to the drive. |
--tag <TAG> | Add a tag. Repeatable. Applies to the drive's Home folder only. |
--folder-color <COLOR> | Set the drive's Home folder color. |
--folder-sticker <STICKER> | Set the drive's Home folder sticker. |
--folder-emoji <EMOJI> | Set the drive's Home folder emoji. |
--member <EMAIL=ROLE> | Invite a member. Repeatable. ROLE is viewer, editor, admin, or owner (default viewer). Requires connectivity. |
Examples
# Create an empty shared drive
poly mkdrive "Design Team"
# Create a drive and invite members
poly mkdrive "Design Team" --member [email protected]=editor --member [email protected]=viewer
# Create a drive with a color and tag
poly mkdrive "Marketing Assets" --folder-color teal --tag red:internal
# Create a drive and hand off ownership immediately
poly mkdrive "Handoff Project" --member [email protected]=owner
Personal roots (//Home, //Archive, //Mind, and //Agent) do not support drive membership. Share a folder inside them, or choose a shared drive from poly ls //.
poly drive history //Home shows changes within Home. The other personal roots support history independently. For a shared drive, poly drive history @handle includes both its home and archive.
Related
rmdrive— permanently delete a shared drive.- Shared Drives — how membership, roles, and archives work.
mkdir— create a regular folder inside a drive.