Account1

admin18

Capacities8

Clusters1

Contracts2

Deployments5

Events1

Grants4

Images10

Instance SKU Catalog1

Instance SKUs3

Instance Templates4

Instances9

Money7

Nodes8

Orderbook4

Orders10

Permissions1

Procurements9

Provider2

Quoter1

Roles5

Users2

VMs6

Workspaces5

Zones2

Nodes

Extend node reservation

Changed on May 18, 2026

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

patch/v1/nodes/{id}/extend

Request

The document declares no server URL.
Auth
none declared

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

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"
  }
}

Changes

May 18, 2026b819ba3108b3 Revision changes
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- info
  added the non-success response with the status
- info
  removed the api_error enum value from the / response property for the response status
- info
  removed the api_error enum value from the / response property for the response status
- info
  removed the api_error enum value from the / response property for the response status
- info
  removed the api_error enum value from the / response property for the response status
- info
  removed the api_error enum value from the / response property for the response status
- info
  removed the authentication_error enum value from the / response property for the response status
- info
  removed the authentication_error enum value from the / response property for the response status
- info
  removed the authentication_error enum value from the / response property for the response status
- info
  removed the authentication_error enum value from the / response property for the response status
- info
  removed the authentication_error enum value from the / response property for the response status
- info
  removed the conflict enum value from the / response property for the response status
- info
  removed the conflict enum value from the / response property for the response status
- info
  removed the conflict enum value from the / response property for the response status
- info
  removed the conflict enum value from the / response property for the response status
- info
  removed the conflict enum value from the / response property for the response status
- info
  removed the conflict enum value from the / response property for the response status
- info
  removed the forbidden enum value from the / response property for the response status
- info
  removed the forbidden enum value from the / response property for the response status
- info
  removed the forbidden enum value from the / response property for the response status
- info
  removed the forbidden enum value from the / response property for the response status
- info
  removed the forbidden enum value from the / response property for the response status
- info
  removed the idempotency_error enum value from the / response property for the response status
- info
  removed the idempotency_error enum value from the / response property for the response status
- info
  removed the idempotency_error enum value from the / response property for the response status
- info
  removed the idempotency_error enum value from the / response property for the response status
- info
  removed the idempotency_error enum value from the / response property for the response status
- info
  removed the idempotency_error enum value from the / response property for the response status
- info
  removed the invalid_request_error enum value from the / response property for the response status
- info
  removed the invalid_request_error enum value from the / response property for the response status
- info
  removed the invalid_request_error enum value from the / response property for the response status
- info
  removed the invalid_request_error enum value from the / response property for the response status
- info
  removed the invalid_request_error enum value from the / response property for the response status
- info
  removed the not_found enum value from the / response property for the response status
- info
  removed the not_found enum value from the / response property for the response status
- info
  removed the not_found enum value from the / response property for the response status
- info
  removed the not_found enum value from the / response property for the response status
- info
  removed the not_found enum value from the / response property for the response status
- info
  removed the not_implemented enum value from the / response property for the response status
- info
  removed the not_implemented enum value from the / response property for the response status
- info
  removed the not_implemented enum value from the / response property for the response status
- info
  removed the not_implemented enum value from the / response property for the response status
- info
  removed the not_implemented enum value from the / response property for the response status
- info
  removed the not_implemented enum value from the / response property for the response status
- info
  removed the payment_required enum value from the / response property for the response status
- info
  removed the payment_required enum value from the / response property for the response status
- info
  removed the payment_required enum value from the / response property for the response status
- info
  removed the payment_required enum value from the / response property for the response status
- info
  removed the payment_required enum value from the / response property for the response status
- info
  removed the payment_required enum value from the / response property for the response status
- info
  removed the request_timed_out enum value from the / response property for the response status
- info
  removed the request_timed_out enum value from the / response property for the response status
- info
  removed the request_timed_out enum value from the / response property for the response status
- info
  removed the request_timed_out enum value from the / response property for the response status
- info
  removed the request_timed_out enum value from the / response property for the response status
- info
  removed the request_timed_out enum value from the / response property for the response status
- info
  removed the service_unavailable enum value from the / response property for the response status
- info
  removed the service_unavailable enum value from the / response property for the response status
- info
  removed the service_unavailable enum value from the / response property for the response status
- info
  removed the service_unavailable enum value from the / response property for the response status
- info
  removed the service_unavailable enum value from the / response property for the response status
- info
  removed the service_unavailable enum value from the / response property for the response status
- info
  removed the unprocessable_entity enum value from the / response property for the response status
- info
  removed the unprocessable_entity enum value from the / response property for the response status
- info
  removed the unprocessable_entity enum value from the / response property for the response status
- info
  removed the unprocessable_entity enum value from the / response property for the response status
- info
  removed the unprocessable_entity enum value from the / response property for the response status
- info
  removed the upgrade_required enum value from the / response property for the response status
- info
  removed the upgrade_required enum value from the / response property for the response status
- info
  removed the upgrade_required enum value from the / response property for the response status
- info
  removed the upgrade_required enum value from the / response property for the response status
- info
  removed the upgrade_required enum value from the / response property for the response status
- info
  removed the upgrade_required enum value from the / response property for the response status
May 18, 202603edf542ab39 Revision changes
- info
  removed the resource_unavailable enum value from the / response property for the response status
- info
  removed the resource_unavailable enum value from the / response property for the response status
- info
  removed the resource_unavailable enum value from the / response property for the response status
- info
  removed the resource_unavailable enum value from the / response property for the response status
- info
  removed the resource_unavailable enum value from the / response property for the response status
- info
  removed the resource_unavailable enum value from the / response property for the response status

Operation history (4 revisions)