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

# Terminate spot workloads running on a node you own or manage

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

Reclaims capacity by terminating the spot workloads on a node your org owns, or on which your org manages a reservation (managingOrgIds) that is active and inside its term. 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

- ReclaimSpotWorkloadsRequest
  - `dryRun` boolean — Report what would be terminated, and terminate nothing.
  - `reason` string — Recorded in the audit trail.
  - `unitIds` string[] — Limit to these units. Omit to target 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 (or, on a dry run, that would be)

## Other responses

- `401` — Missing or invalid API key
- `403` — The caller is authenticated but may not do this. The caller's role or the API key's scope does not allow it, or the request targets another organization (FORBIDDEN, or NOT_A_MEMBER for a session), or the organization is suspended pending review (ORG_SUSPENDED) or has been deleted (ORG_DISABLED). A new API key or a wider scope clears neither of the last two; see [Account and balance refusals](https://docs.openrelay.inc/docs/errors#account-and-balance-refusals).
- `404` — Resource not found

## Changes

- **2026-08-13** `138b4ef69d2f` — 1 info
  - added the new optional request property `dryRun`

[Change history](https://skmtc.dev/openrelay/apis/openrelay-api/changes/v1/orgs/:orgId/provider/nodes/:nodeId/reclaim-spot/post.md)

---

[API](https://skmtc.dev/openrelay/apis/openrelay-api.md) · [All operations](https://skmtc.dev/openrelay/apis/openrelay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openrelay/apis/openrelay-api/revisions/bcf63adad2c3?raw)