References
Volume Tools
MCP tools for listing, resizing, and deleting persistent volumes
Persistent volumes provide durable storage for services and templates. A service can attach a volume through service_create or service_update with volume_name, volume_mount_path, and volume_size_gi.
volume_list
List persistent volumes in a workspace or project, including active and detached volumes.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workspace | string | no | default | Workspace slug |
project | string | no | — | Project slug filter |
Returns: volumes with name, mount_path, size_gi, status, service_id, and delete_by for detached volumes.
volume_resize
Grow a persistent volume. Volumes can be expanded but not shrunk.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workspace | string | no | default | Workspace slug |
name | string | yes | — | Volume name |
size_gi | integer | yes | — | New size in GiB; must be larger than current size |
project | string | no | default | Project slug |
Returns: name, size_gi, and status.
volume_delete
Permanently delete a detached volume and its data. Delete the service first if the volume is still attached.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workspace | string | no | default | Workspace slug |
name | string | yes | — | Detached volume name |
project | string | no | default | Project slug |
Returns: message.
Lifecycle
- New volumes default to
1GiB unlessvolume_size_gior a template variable sets a larger size. - Database templates default their storage inputs to
10GiB. - Deleting a service detaches its volumes. Detached volumes are retained for 24 hours unless reattached or deleted.
- Storage counts against the workspace storage cap and is billed at
$0.0000035per GB-minute while the volume exists.