Delete region
Permanently deletes a region. A region that is still in use by a cluster, an active offer, an open order or an enabled cluster pool cannot be deleted: the request fails with 409 and the error names what uses it, with the counts in metadata (reason: region_in_use, clusters, active_offers, open_order_drafts, cluster_pool_enabled). Requires workspace owner or admin.
Authorizations
workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens
Headers
Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens — a workspace-owned token implies its workspace.
1 - 53"ws_j572abc123def456"
The etag of the resource version the client last read. Required on writes when the resource exposes an etag field. Mismatch returns 409 ABORTED with the current etag in the error metadata.
1 - 256"42"
Path Parameters
Region ID. Prefixed form reg_<id> is canonical.
1 - 54"reg_j572abc123def456"
Response
Region deleted