Delete Cluster
Deletes a cluster record and revokes its enrolment tokens. Fails with FailedPrecondition while any namespace is placed on it unless force is set, and always for the default cluster. A connected operator loses its credential on its next heartbeat.
Access: admin of the owner team, or a platform admin. Other callers get NotFound.
Authorization
BearerAuth A namespace-scoped API key (cpk_…) for machines, or a Xeonr Auth OIDC
token for humans. The key's namespace and role are pinned server-side.
In: header
Header Parameters
Define the version of the Connect protocol
Define the timeout, in ms
Request Body
application/json
^cl-[0-9a-f]{16}$Delete even while namespaces are placed on the cluster. Their records stay, pointing at a cluster that no longer exists, until each is deleted. validate:skip a bool has no bounds
Response Body
application/json
application/json
curl -X POST "https://containers.xeonr.io/containers.api.v1.ClusterService/DeleteCluster" \ -H "Connect-Protocol-Version: 1" \ -H "Connect-Timeout-Ms: 1000" \ -H "Content-Type: application/json" \ -d '{}'{}{
"code": "not_found",
"message": "string",
"details": [
{
"type": "string",
"value": "string",
"debug": {}
}
]
}Create Enrolment Token POST
Mints a one-time enrolment token for a cluster, valid for 15 minutes, which an operator install exchanges for its cluster credential on first start. The secret is returned exactly once. Minting a new token does not revoke an unspent earlier one until it expires. **Access:** admin of the owner team, or a platform admin. Other callers get NotFound.
Get Cluster POST
Returns a cluster record. A cluster the caller cannot see is reported as NotFound. **Access:** a member of the owner team or of a team holding a grant, any caller for a GLOBAL cluster, a namespace API key for the cluster its namespace is placed on, or a platform admin.