Update a GPU VM

Update GPU VM metadata (name, resource group, SSH key association, username). Requires GPU feature to be enabled.

Path Parameters

id
Type: stringFormat: uuid
required

The GPU VM ID

Body

required

application/json

name
Type: string
min length:
1
max length:
63

New display name for the GPU VM. Letters, numbers, spaces, periods, and hyphens only; cannot start or end with a hyphen.
resourceGroupId
Type: stringFormat: uuid

The resource group to move the GPU VM into. Omitted leaves it where it is. null is refused (422): every GPU VM belongs to a resource group, so to take one out of a group, move it into your tenant's Default resource group. A move requires gpu:update in both the current and the destination group.
sshKeyId
Type: stringFormat: uuidnullable

SSH key ID to associate with the VM, or null to clear the association
username
Type: string
min length:
3
max length:
20

Username for SSH access (must start with a letter or underscore)

Responses

application/json
application/json
application/json
application/json
application/json
application/json
application/json

put/resource/gpu/{id}

curl https://api.gpcn.com/v1/resource/gpu/123e4567-e89b-12d3-a456-426614174000 \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN' \
  --data '{
  "name": "GPU Trainer 1",
  "resourceGroupId": "",
  "sshKeyId": "",
  "username": ""
}'

Show Schema

{
  "success": true,
  "message": "string",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "string",
    "createdAt": "2026-10-21T16:19:07.193Z",
    "updatedAt": "2026-10-21T16:19:07.193Z",
    "deletedAt": "2026-10-21T16:19:07.193Z",
    "status": "Provisioning",
    "configuration": {
      "name": "string",
      "code": "string",
      "gpuCount": 1,
      "cpu": 1,
      "ram": 1,
      "disk": 1,
      "skuId": "123e4567-e89b-12d3-a456-426614174000",
      "skuCode": "string"
    },
    "ip": "string",
    "datacenter": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "string",
      "region": "string",
      "countryAbbr": "string",
      "country": "string"
    },
    "resourceGroupId": "123e4567-e89b-12d3-a456-426614174000",
    "resourceGroupName": "string",
    "image": "string",
    "username": "string",
    "sshKeyId": "123e4567-e89b-12d3-a456-426614174000",
    "sshKeyName": "string",
    "hasStoredCredentials": true,
    "error": {
      "code": "GPU_PROVIDER_UNAVAILABLE",
      "message": "string"
    }
  },
  "meta": null
}

GPU VM updated successfully

Get GPU VM details

Delete a GPU VM