Skip to main content
DELETE
Deprovision a Hetzner cluster

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization
string | null
x-ankra-organisation-id
string | null

Path Parameters

cluster_id
string<uuid>
required

Query Parameters

force
string | null

Set to 'true' to force deprovision without waiting for the cluster agent. Use only when the cluster agent is permanently offline; cloud resources may leak if Vault or the agent cannot be reached during teardown.

accept_volume_data_loss
string | null

Set to 'true' to accept that the cluster's persistent volumes - the cloud volumes its CSI driver provisioned - and the data on them are deleted with the cluster, unless its retention_policy retains them. GET .../deprovision-volumes lists them. Required, forced or not, when the delete removes volumes or cannot tell whether it does: without it the delete answers 409 naming them.

Response

Cluster deprovisioned successfully

cluster_id
string<uuid4>
required
operation_id
string<uuid4> | null
success
boolean
default:true