cluster.delete

Provider-neutral Kubernetes cluster deletion orchestration.

Overview

Property	Value
Workflow type	Linear
Library	App-clusters
Version	1.0

Input Schema

Field	Type	Required	Default	Description
organization_uuid	uuid	Yes	—	Organization UUID for tenant isolation.
cluster_uuid	uuid	No	—	Logical cluster UUID to delete.
provider	string	No	—	Provider key when cluster_uuid is not supplied.
cluster_kind	string	No	—	eks, gke, aws-vm, gcp-vm, or mgc-kubernetes.
provider_connection_uuid	uuid	No	—	Provider CloudConnection UUID.
provider_cluster_ref	string	No	—	Provider-side cluster identifier.
region	string	No	—	Primary provider region or location.
provider_config	json	No	—	Provider-specific delete/status inputs for supported provider workflows.
node_config	json	No	—	Provider-specific node pool or nodegroup identifiers.
connection_uuid	uuid	No	—	Kubernetes CloudConnection UUID associated with the cluster.
delete_connection	boolean	No	—	Whether to soft-delete the Kubernetes CloudConnection.
force	boolean	No	—	Continue best-effort cleanup when provider reports not found.
actor	string	No	—	Caller initiating deletion.
timeout_seconds	integer	No	—	Provider deletion timeout.
poll_interval	integer	No	—	Provider deletion polling interval.

Output Schema

Field	Type	Required	Default	Description
organization_uuid	uuid	No	—	Organization UUID echoed from input.
cluster_uuid	uuid	No	—	Logical cluster UUID.
provider	string	No	—	Provider key.
cluster_kind	string	No	—	Cluster kind.
provider_connection_uuid	uuid	No	—	Provider CloudConnection UUID.
provider_cluster_ref	string	No	—	Provider-side cluster identifier.
region	string	No	—	Primary provider region or location.
provider_config	json	No	—	Provider-specific delete/status inputs.
node_config	json	No	—	Provider-specific node pool or nodegroup identifiers.
connection_uuid	uuid	No	—	Associated Kubernetes CloudConnection UUID.
delete_connection	boolean	No	—	Whether to soft-delete the Kubernetes CloudConnection.
force	boolean	No	—	Continue best-effort cleanup when provider reports not found.
actor	string	No	—	Caller initiating deletion.
timeout_seconds	integer	No	—	Provider deletion timeout.
poll_interval	integer	No	—	Provider deletion polling interval.
cluster	json	No	—	Output from data.cluster.get when cluster_uuid was supplied.
provider_delete_workflow	string	No	—	Provider delete workflow type.
provider_delete_input	json	No	—	Input sent to the provider delete workflow.
provider_delete_child_workflow_id	string	No	—	Workflow id for the provider delete child.
provider_delete	json	No	—	Output from the selected provider delete workflow.
status	string	No	—	Normalized deletion status.
deleted	boolean	No	—	True when provider deletion completed or object was absent under force.
connection_deleted	boolean	No	—	True when the Kubernetes CloudConnection was soft-deleted.
deleted_at	string	No	—	ISO deletion timestamp.
completed_at	string	No	—	ISO completion timestamp.
failure_reason	string	No	—	Human-readable failure reason.
failure_type	string	No	—	Failure category.
failed_action	string	No	—	Action that failed.
failed_step	json	No	—	Failed logical step or child workflow.
failed_layer	json	No	—	Engine failed layer when applicable.
failed_at_state	string	No	—	State where failure occurred.
error	string	No	—	Error message.
error_type	string	No	—	Error class.
failed_at	string	No	—	ISO failure timestamp.

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	load_cluster	—
deleting_provider	No	No	—	—	—
loading_cluster	No	No	—	dispatch_provider_delete	—
marking_deleted	No	No	—	complete	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
pending	load_cluster	loading_cluster	—
loading_cluster	dispatch_provider_delete	deleting_provider	—
deleting_provider	child_done	marking_deleted	—
deleting_provider	child_failed	failed	—
marking_deleted	complete	completed	—
* (any state)	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "cluster.delete",
  "initial_data": {
    "organization_uuid": "value"
  }
}