---
title: "Destroy Volume"
method: DELETE
path: "/v1/apps/{app_name}/volumes/{volume_id}"
tags: ["Volumes"]
---

# Destroy Volume

`DELETE /v1/apps/{app_name}/volumes/{volume_id}`

## Request

- Base URL: `https://api.machines.dev`
- URL: `https://api.machines.dev/v1/apps/{app_name}/volumes/{volume_id}`
- Auth: HTTP bearer

Delete a specific volume within an app by volume ID.

## Path parameters

- `app_name` string, required
- `volume_id` string, required

## Response `200`

OK

- Volume
  - `attached_alloc_id` string
  - `attached_machine_id` string
  - `auto_backup_enabled` boolean
  - `block_size` integer
  - `blocks` integer
  - `blocks_avail` integer
  - `blocks_free` integer
  - `bytes_total` integer
  - `bytes_used` integer
  - `created_at` string
  - `encrypted` boolean
  - `fstype` string
  - `host_features` string[]
  - `host_status` 'ok' | 'unknown' | 'unreachable'
  - `id` string
  - `name` string
  - `region` string
  - `required_host_features` string[]
  - `size_gb` integer
  - `snapshot_retention` integer
  - `state` string
  - `type` 'local' | 'cache'
  - `zone` string

## Changes

- **2026-09-18** `b1988c8e4bd9`: 2 info
  - added the optional property `host_features` to the response with the `200` status
  - added the optional property `required_host_features` to the response with the `200` status
- **2026-08-12** `f54480c4ce7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/machines/apis/machines-api/changes/v1/apps/:app_name/volumes/:volume_id/delete.md)

---

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