Skip to main content
Deletes a registered node from the control plane.
DELETE /api/v1/nodes/{name}
You cannot delete a node that has projects in the Scheduled, Running, or Terminating phase. The server returns 409 Conflict and lists how many projects are still assigned. Delete or wait for those projects to finish before removing the node.

Path parameters

name
string
required
The unique name of the node to delete.

Response

Returns 204 No Content on success. The node record is removed from the store immediately. Returns 404 Not Found if the node does not exist. Returns 409 Conflict if one or more projects are still assigned to the node.

Example

curl -X DELETE http://localhost:8080/api/v1/nodes/worker-01