Bulk Detach Volumes

​

Detach multiple volumes from their attached virtual machines in a single request. Each volume detach is handled as an independent async workflow job, allowing partial success.

  • Validates each volume exists and belongs to the user's entity
  • Creates separate detach jobs for each volume
  • Returns job tracking information for all detach operations
Body·
required
application/json

Request body for bulk operations with UUID-based IDs

  • ids
    Type: array string[] 1…50
    required

    Array of resource UUIDs (1-50)

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/resource/volumes/bulk/detach
curl https://api.gpcn.com/v1/resource/volumes/bulk/detach \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN' \
  --data '{
  "ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "660e8400-e29b-41d4-a716-446655440001"
  ]
}'

{
  "success": true,
  "message": "string",
  "data": {
    "jobs": [
      {
        "jobId": "123e4567-e89b-12d3-a456-426614174000",
        "resourceType": "virtual_machine",
        "resourceDisplayName": "string",
        "operation": "create",
        "stage": "initializing",
        "progressPercentage": 0,
        "message": "string",
        "errorMessage": "string",
        "estimatedCompletion": "2026-05-19T14:02:02.487Z",
        "timeRemaining": "string",
        "canRetry": true,
        "isCompleted": true,
        "hasFailed": true,
        "resourceId": "123e4567-e89b-12d3-a456-426614174000",
        "resourceName": "string",
        "createdAt": "2026-05-19T14:02:02.487Z",
        "updatedAt": "2026-05-19T14:02:02.487Z"
      }
    ]
  },
  "meta": null
}

Bulk volume detach initiated successfully