---
title: "Delete a virtual machine storage attachment"
method: DELETE
path: "/vm/{rid}/storage/{storageId}"
tags: ["VM"]
---

# Delete a virtual machine storage attachment

`DELETE /vm/{rid}/storage/{storageId}`

Remove a storage attachment from a shut-off virtual machine. Backing data is preserved by default. Set deleteBacking=true to permanently delete the managed RAW file or ZFS volume as well. Backing deletion is not supported for Downloader media or filesystem shares. Storage topology changes are blocked while the VM is protected by replication.

## Path parameters

- `rid` integer, required
- `storageId` integer, required

## Query parameters

- `deleteBacking` boolean

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseAny
  - `data` unknown
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error
- `503` — Service Unavailable

## Changes

- **2026-09-07** `883dbcb5b8be` — 1 info
  - added the new optional `query` request parameter `deleteBacking`
- **2026-08-12** `9a5026bf9057` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/alchemillahq/apis/sylve-api/changes/vm/:rid/storage/:storageId/delete.md)

---

[API](https://skmtc.dev/alchemillahq/apis/sylve-api.md) · [All operations](https://skmtc.dev/alchemillahq/apis/sylve-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alchemillahq/apis/sylve-api/revisions/6d4b8bb77d9a?raw)