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
Related
rmdrive— permanently delete a shared drive.- Shared Drives — how membership, roles, and archives work.
mkdir— create a regular folder inside a drive.