Delete Cluster

You can delete a specific cluster using its clusterId.

Prerequisite: Only contract administrators, owners, and users with accessAndManageNFS privilege can delete clusters via the API.

Endpoints

Use a region-specific endpoint to delete a cluster: https://nfs.{region}.ionos.com/clusters/{clusterId}

Request

Note: The following request contains sample values. Remember to replace them with the relevant information.

curl -X 'DELETE' \
  'https://nfs.de-txl.ionos.com/clusters/e69b22a5-8fee-56b1-b6fb-4a07e4205ead' \
  -H 'accept: application/json'
  -H 'Authorization: Basic <auth-token>'

Request Header Parameters

To make authenticated requests to the API, the following fields are mandatory in the request header:

Header Parameters	Required	Type	Description
Authorization	yes	string	You can use Basic Authentication or a Bearer token. For more information, see Authentication.
Content-Type	yes	string	Set this to application/json.

Path Parameters

Below is the list of mandatory path parameter:

Body Parameters	Type	Description	Example
clusterId	string	The ID (UUID) of the Cluster.	e69b22a5-8fee-56b1-b6fb-4a07e4205ead

Response

A 202 message confirms that the specified cluster has been successfully deleted.