---
title: "Cluster Force Node Upgrade"
method: POST
path: "/api/v1.cluster-admin.force-node-upgrade"
tags: ["ClusterAdmin"]
---

# Cluster Force Node Upgrade

`POST /api/v1.cluster-admin.force-node-upgrade`

Request that the cluster upgrade the given node from "learner" to "voter"

This should only be invoked if a partition occurs during a learner process
and you don't want to re-bootstrap the affected node.

## Request body

- ClusterForceNodeUpgradeIn
  - `node_id` string, required

## Response `200`

- ClusterForceNodeUpgradeOut
  - `initial_node_state` 'leader' | 'follower' | 'learner' | 'candidate' | 'shutdown' | 'unknown', required
  - `final_node_state` 'leader' | 'follower' | 'learner' | 'candidate' | 'shutdown' | 'unknown', required

## Other responses

- `400`
- `401`
- `403`
- `422`

## Changes

- **2026-10-06** `9a3ae34ab951` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/svix/apis/diom-api/changes/api/v1.cluster-admin.force-node-upgrade/post.md)

---

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