---
title: "Terminate spot workloads running on a node your org owns"
method: POST
path: "/v1/orgs/{orgId}/provider/nodes/{nodeId}/reclaim-spot"
tags: ["Provider"]
---

# Terminate spot workloads running on a node your org owns

`POST /v1/orgs/{orgId}/provider/nodes/{nodeId}/reclaim-spot`

Reclaims capacity by terminating the spot workloads on one of your nodes. Scoped strictly to workloads bought at the spot tier: a spot instance is sold on the explicit contract that the capacity owner can terminate it at any time. Non-spot workloads on the node are never touched. Every termination is audited and the affected VM records capacity reclaim as its reason, so the customer is not told it was a platform fault.

## Path parameters

- `orgId` string, required
- `nodeId` string, required

## Request body

- object
  - `reason` string — Recorded in the audit trail
  - `unitIds` string[] — Limit to spot workloads holding these GPU units. Omit to reclaim every spot workload on the node.

## Response `200`

OK

- ReclaimSpotWorkloadsResult
  - `skipped` string[] — VM ids left alone because they are not spot
  - `terminated` string[], required — VM ids terminated

## Other responses

- `401` — Missing or invalid API key
- `403` — API key lacks the required scope
- `404` — Resource not found

---

[API](https://skmtc.net/openrelay/apis/openrelay-api.md) · [All operations](https://skmtc.net/openrelay/apis/openrelay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openrelay/openrelay-api/versions/32905b8f44f8/schema)