---
title: "Rename a cluster machine"
method: POST
path: "/v1/projects/{projectId}/cluster-machines/{id}:rename"
tags: ["Clusters"]
---

# Rename a cluster machine

`POST /v1/projects/{projectId}/cluster-machines/{id}:rename`

Renames a machine in a cluster. This can be useful if you are assigning specific roles to machines in the cluster.

## Path parameters

- `projectId` string, required
- `id` string, required

## Query parameters

- `newId` string, required

## Response `200`

A successful response.

- object

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/cudocompute/apis/cudo-compute-service.md) · [All operations](https://skmtc.net/cudocompute/apis/cudo-compute-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cudocompute/cudo-compute-service/versions/93dc40dababc/schema)