Stop billing and delete the VM and boot disk

DELETE

/v1/spot/nodes/{id}

curl --request DELETE \
  --url https://example.com/v1/spot/nodes/example \
  --header 'Authorization: Bearer <token>'

Idempotent. Billing stops when release is accepted; the node may remain terminating while deletion is retried.

Authorizations

• bearer

Parameters

Path Parameters

id

required

string

Header Parameters

Nodus-Org

string

Organization to select with a user token; API keys are already scoped.

Responses

200

OK

Media type application/json

object

billed_seconds

required

integer format: int64

billing_warning

string

cleaned_at

string format: date-time

cost_so_far

required

number format: double

created_at

required

string format: date-time

end_reason

string

ended_at

required

string | null format: date-time

gpu

required

string

id

required

string

ip

required

string

price_per_node_hr

required

number format: double

provider

required

string

ready_at

required

string | null format: date-time

region

required

string

region_class

string

region_name

string

release_at

string format: date-time

retry_after

integer format: int64

ssh_command

string

ssh_port

required

integer format: int64

ssh_user

required

string

started_at

required

string | null format: date-time

startup_failure_code

string

Allowed values: capacity_unavailable

startup_failure_message

string

status

required

string

Allowed values: provisioning running preempted terminating terminated failed

workspace_id

string

workspace_slot

string

Example

{
  "startup_failure_code": "capacity_unavailable",
  "status": "provisioning"
}

default

Spot error or platform authentication failure

Media type application/json

object

current_price

number format: double

error

required

string

message

string

retry_after

integer format: int64

Example ^generated

{
  "current_price": 1,
  "error": "example",
  "message": "example",
  "retry_after": 1
}