[[delete-desired-nodes]]
=== Delete desired nodes API
++++
<titleabbrev>Delete desired nodes</titleabbrev>
++++

NOTE: {cloud-only}

..New API reference
[sidebar]
--
For the most up-to-date API details, refer to {api-es}/group/endpoint-cluster[Cluster APIs].
--

Delete desired nodes.

[[delete-desired-nodes-request]]
==== {api-request-title}

//////////////////////////
[source,console]
--------------------------------------------------
PUT /_internal/desired_nodes/history/1
{
    "nodes" : [
        {
            "settings" : {
                 "node.name" : "instance-000187",
                 "node.external_id": "instance-000187",
                 "node.roles" : ["data_hot", "master"],
                 "node.attr.data" : "hot",
                 "node.attr.logical_availability_zone" : "zone-0"
            },
            "processors" : 8.0,
            "memory" : "58gb",
            "storage" : "2tb"
        }
    ]
}
--------------------------------------------------
// TESTSETUP
//////////////////////////

[source,console]
--------------------------------------------------
DELETE /_internal/desired_nodes
--------------------------------------------------
// TEST

[[delete-desired-nodes-desc]]
==== {api-description-title}

This API deletes the desired nodes.

[[delete-desired-nodes-examples]]
==== {api-examples-title}

This example deletes the current desired nodes.

[source,console]
--------------------------------------------------
DELETE /_internal/desired_nodes
--------------------------------------------------
// TEST