Commands

rmdrive

Permanently delete a shared drive.

poly rmdrive permanently deletes a shared drive, including its home, archive, and every file inside. This is permanent and cannot be undone — there is no archive step like rm.

Usage

poly rmdrive <TARGET> [-f|--force]

TARGET can be the drive's handle (@my-drive), the path to its home folder, a deep link (polyapp://shared/my-drive), or a web URL.

By default, rmdrive prompts for confirmation before deleting. See Shared Drives for how drives and membership work.

Flags

FlagDescription
-f, --forceSkip the confirmation prompt. Required if stdin isn't a terminal (e.g. scripts, CI).

Examples

# Delete a drive by handle, with a confirmation prompt
poly rmdrive @design-team

# Delete a drive by its home folder path
poly rmdrive //shared/old-project

# Skip the prompt in a script
poly rmdrive @old-project --force

# Delete using a deep link
poly rmdrive polyapp://shared/old-project
  • mkdrive — create a shared drive.
  • Shared Drives — how membership, roles, and archives work.
  • rm — soft-delete individual files and folders.
© Poly Corp. 2026