---
title: "Delete an entire volume directory"
method: DELETE
path: "/volumes"
tags: ["pv"]
---

# Delete an entire volume directory

`DELETE /volumes`

## Request

- The document declares no server URL.
- Auth: none declared

Remove base_path (a Volume's shared-storage sub-directory) and everything under it; deleting a missing directory is idempotent

## Query parameters

- `base_path` string, required

## Response `200`

OK

- PkgServerVolumefsDeleteResponse
  - `deleted` boolean

## Changes

- **2026-10-22** `b7207bf13d2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tencentblueking/apis/untitled-api/changes/volumes/delete.md)

---

[API](https://skmtc.dev/tencentblueking/apis/untitled-api.md) - [All operations](https://skmtc.dev/tencentblueking/apis/untitled-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tencentblueking/apis/untitled-api/revisions/b7207bf13d2c?raw)