---
title: "DELETE /v1/volumes/:id — schedule a volume for deletion (API key, org inferred from key)."
method: DELETE
path: "/v1/volumes/{id}"
tags: ["volumes"]
---

# DELETE /v1/volumes/:id — schedule a volume for deletion (API key, org inferred from key).

`DELETE /v1/volumes/{id}`

Schedule an unused named volume for deletion.

## Path parameters

- `id` string, uuid, required

## Response `200`

Volume scheduled for deletion

- MessageResponse — Simple message response for operations without a body.
  - `message` string, required

## Other responses

- `401` — Unauthorized
- `404` — Volume not found
- `409` — The default volume cannot be deleted

---

[API](https://skmtc.dev/microsandbox/apis/microsandbox-api.md) · [All operations](https://skmtc.dev/microsandbox/apis/microsandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microsandbox/microsandbox-api/revisions/23f2a45cb09b/schema)