Delete a detached volume and its data, for good. Admins only.
The volume stays listed, being deleted, until its cluster confirms. Also deletes a volume Pyo has no record of, listed in its cluster's strayVolumes: pass that volumeId as id, with clusterId.
API key access: full.
apiKeyAuthorizationBearer <pyo_…>An API key from the dashboard's API keys page: Authorization: Bearer pyo_…. Keys can expire, and an expired one gets a 401.
application/jsonDelete a detached volume and its data, for good. Admins only.
The volume stays listed, being deleted, until its cluster confirms. Also deletes a volume Pyo has no record of, listed in its cluster's strayVolumes: pass that volumeId as id, with clusterId.
API key access: full.
op*"deleteVolume""deleteVolume"id*stringclusterId?|Only for a volume from a cluster's strayVolumes.
Done. Always ok: true, and some operations add more, such as a new API key or a join command. A warning comes with a change that went through but won't fully take effect yet, such as more replicas than the servers have room for.
application/jsoncurl -X POST 'https://your-pyo.example.com/api/v1/ops' \
-H 'Content-Type: application/json' \
-d '{
"clusterId": "cl_8kq2x7ad",
"id": "vol_8kq2x7ad",
"op": "deleteVolume"
}'{}