---
title: "Perform action on a cluster node"
method: POST
path: "/v1/clusters/{clusterId}/nodes/{nodeId}/actions"
tags: ["Clusters"]
---

# Perform action on a cluster node

`POST /v1/clusters/{clusterId}/nodes/{nodeId}/actions`

Start or shut down a single node inside a cluster (worker, jumphost, or CPU service node).

    Supported `action` values:
    - `boot` — start the node
    - `shutdown` — graceful shutdown
    - `force_shutdown` — force the node off

## Path parameters

- `clusterId` string, required
- `nodeId` string, required

## Headers

- `user-agent` string, required
- `cf-connecting-ip` string, required

## Request body

- PerformClusterNodeActionPublicDto
  - `action` 'boot' | 'shutdown' | 'force_shutdown', required

## Response `202`

Action dispatched

## Other responses

- `400` — Invalid action
- `404` — Cluster or node not found

---

[API](https://skmtc.net/datacrunch/apis/verda-cloud-public-api.md) · [All operations](https://skmtc.net/datacrunch/apis/verda-cloud-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datacrunch/verda-cloud-public-api/revisions/0d66c7340876/schema)
