Detach volumes from instance

POST

/instances/{vm_id}/detach-volumes/

Detach one or more storage volumes from a virtual machine. The VM must be stopped before detaching volumes. OS volumes cannot be detached. All volumes must be currently attached to the specified VM and in the same tier and region. Supports detaching up to 10 volumes in a single request.

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Volumes detached successfully

Body

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://barrack.ai/api/instances//detach-volumes/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "volume_ids": [
        "string"
    ]
}'

Response Example

200 - Success

{
    "success": true,
    "message": "Volumes detached successfully",
    "volume_ids": [
        "BRK-123456V"
    ],
    "vm_id": "BRK-123456D",
    "tier": "legacy",
    "region": "CANADA-1",
    "status": "completed"
}

Attach volumes to instance

List available volume types