Volumes

Detach a shared volume from a workspace

202 with the attachment (state detaching) and its volume_detach operation; the cell unmounts it (the guest sees I/O errors on the path afterwards, never stale writes) and reports detached. Idempotent while detaching. 404 when the volume is not attached. 409 operation_in_progress while another lifecycle operation of the workspace runs. Supports Idempotency-Key.

delete/v1/workspaces/{workspace_id}/volumes/{volume_id}

Request

  • Base URL: https://api.shardflux.dev
  • URL: https://api.shardflux.dev/v1/workspaces/{workspace_id}/volumes/{volume_id}
  • Auth: HTTP bearer

Path parameters

workspace_idstring uuid required

UUIDv7, lowercase canonical form.

volume_idstring uuid required

UUIDv7, lowercase canonical form.

Response

operation is null only for an idempotent re-attach of an already attached volume (200).

Changes

No recorded changes to this operation across all 1 revision of this API.