Skip to main content
DELETE/vault/hyok/hosts/{host_id}

Delete Host

Deregisters a host.

It is refused while the host is in a cluster: remove it from the cluster first.

The host's record is kept with the status deregistered.

Deregistering it again returns 204.

Needs ORG_ADMIN.

Parameters
orgId *query

The organisation's id.

host_id *path

The host's id: hyokhost_ and a UUID.

Responses
HTTPK9O CodeDescription
204The host is deregistered.
404No such host.
409`HYOK_HOST_IN_CLUSTER`: the host is in a cluster.
500An internal error. Retry later.
cURL
curl -X DELETE 'https://<org>.api-<region>.k9o.io/@storefront/vault/hyok/hosts/<hostId>' \
  -H 'Authorization: Bearer $K9O_TOKEN'

Showing example in cURL

More in HYOK Clusters & Hosts