---
title: "volume delete"
slug: "volume-delete"
tags: ["5.4"]
updated: 2026-10-28T01:53:01Z
published: 2026-10-28T01:53:01Z
canonical: "docs.vastdata.com/volume-delete"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# volume delete

This command deletes a block storage volume.

## Usage

```plaintext
volume delete --id ID
              [--force]
```

## Required Parameters

| `--id ID` | Specifies which volume to delete. |
| --- | --- |

## Options

| `--force` | If hosts are mapped to the volume, this option forces unmapping of the hosts and deletion of the volume. |
| --- | --- |

## Example

```plaintext
vcli: admin> volume delete --id 1
Are you sure you want to delete the volume? [y/N] y
Command REST Error: {"detail":"Volume is mapped to hosts"}
vcli: admin> volume delete --id 1 --force
Are you sure you want to delete the volume? [y/N] y
vcli: admin>
```