---
title: "Remove a template default volume"
method: DELETE
path: "/v1/project-templates/environment/volumes/{volume_id}"
tags: ["Agent environments"]
---

# Remove a template default volume

`DELETE /v1/project-templates/environment/volumes/{volume_id}`

## Request

- Base URL: `https://api.shardflux.dev`
- URL: `https://api.shardflux.dev/v1/project-templates/environment/volumes/{volume_id}`
- Auth: HTTP bearer

## Path parameters

- `volume_id` string, uuid, required

## Query parameters

- `project_id` string, uuid
- `repo_remote` string

## Response `200`

Default Response

- object
  - `volumes` object[], required
    - `id` string, uuid, required
    - `volume_id` string, uuid, required
    - `name` string, required
    - `mount_path` string, required
    - `mode` union, required
      - 'ro'
      - 'rw'
    - `source` union, required
      - 'machine'
      - 'template'
  - `live` object[], required
    - `workspace_id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `volume_id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `status` string, required
    - `reason` string
    - `operation_id` string, uuid: UUIDv7, lowercase canonical form.

## Other responses

- `4XX`: Default Response
- `5XX`: Default Response

---

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