Sign in

v44

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-20129390589.6 KB
Nodes

Extend node reservation

Purchase additional time to extend the end time of a reserved VM node

patch/v1/nodes/{id}/extend

Path parameters

idstring required

Node ID or name

Request body

duration_secondsinteger required

Duration in seconds to extend the node Must be at least 1 hour (3600 seconds) and a multiple of 1 hour.

max_price_per_node_hourinteger required

Max price per hour for the extension in cents

Example request

{
  "duration_seconds": 7200,
  "max_price_per_node_hour": 1000
}

Response

Node extended successfully

objectstring required
idstring required
namestring required
zonestring nullable
gpu_type'H100' | 'H200' required
ownerstring required
status'pending' | 'awaitingcapacity' | 'running' | 'released' | 'terminated' | 'deleted' | 'failed' | 'unknown' required

Node Status

created_atinteger nullable

Creation time as Unix timestamp in seconds

updated_atinteger nullable

Last updated time as Unix timestamp in seconds

start_atinteger nullable

Start time as Unix timestamp in seconds

end_atinteger nullable

End time as Unix timestamp in seconds

deleted_atinteger nullable

Deletion time as Unix timestamp in seconds

procurement_idstring nullable
max_price_per_node_hourinteger nullable

Max price per hour you're willing to pay for a node in cents

node_type'autoreserved' | 'reserved' required

Example response

{
  "object": "node",
  "id": "n_b1dc52505c6db142",
  "name": "cuda-crunch",
  "zone": "hayesvalley",
  "owner": "sfcompute",
  "created_at": 1640995200,
  "updated_at": 1640995200,
  "start_at": 1640995200,
  "end_at": 1640995200,
  "deleted_at": 1640995200,
  "procurement_id": "proc_b1dc52505c6de142",
  "max_price_per_node_hour": 1000,
  "vms": {
    "object": "list",
    "data": [
      {
        "object": "vm",
        "id": "vm_myOZZXw4pfcp7H9DQOldd",
        "created_at": 1640995200,
        "updated_at": 1640995200,
        "start_at": 1640995200,
        "end_at": 1640998200,
        "image_id": "image_myOZZXw4pfcp7H9DQOldd",
        "zone": "hayesvalley"
      }
    ]
  },
  "current_vm": {
    "object": "vm",
    "id": "vm_myOZZXw4pfcp7H9DQOldd",
    "created_at": 1640995200,
    "updated_at": 1640995200,
    "start_at": 1640995200,
    "end_at": 1640998200,
    "image_id": "image_myOZZXw4pfcp7H9DQOldd",
    "zone": "hayesvalley"
  }
}