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

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Volumes detached successfully

Body

🟠400

🟠401

🟠404

🟠409

🔴500

🔴502

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://barrack.ai/api/instances//detach-volumes/' \
--header 'X-API-Key: <api-key>' \
--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 volumes