---
title: "Replace node"
method: POST
path: "/v2/nodes/{id}/replace"
tags: ["Nodes"]
---

# Replace node

`POST /v2/nodes/{id}/replace`

Replace a node by destroying the existing one and creating a new node in the same capacity. Optionally specify a new image and cloud-init user data.

## Path parameters

- `id` string, required — Generated ID with format 'node_[0-9a-zA-Z]+' used for referencing a NodeId resource.

## Request body

- VmorchReplaceNodeRequest
  - `template` string, nullable

## Response `200`

Replacement node

- VmorchNodeResponse
  - `object` 'node'
  - `id` string, required — Generated ID with format 'node_[0-9a-zA-Z]+' used for referencing a NodeId resource.
  - `status` 'pending' | 'running' | 'terminated' | 'node_failure', required
  - `capacity` string, required — Generated ID with format 'cap_[0-9a-zA-Z]+' used for referencing a CapacityId resource.
  - `template` string, required — Generated ID with format 'ntmpl_[0-9a-zA-Z]+' used for referencing a NodeTemplateId resource.

## Other responses

- `401` — Unauthorized
- `403` — Feature not enabled
- `404` — Node not found

## Changes

- **2026-02-10** `e161bba8bfda` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation/changes/v2/nodes/:id/replace/post.md)

---

[API](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation.md) · [All operations](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sfcompute/san-francisco-compute-documentation/revisions/e161bba8bfda/schema)