Delete Tenant

Required role: owner.

Delete a tenant that holds nothing. Its members lose the membership, and a login that still resolves this tenant's name simply re-creates it, empty.

The tenant must hold no pipelines, API keys or OIDC trust relationships; otherwise the request fails with a conflict. Everything tenant-scoped cascades on this delete, so the emptiness rule is what keeps a mistyped identifier from taking a live tenant's pipelines with it. Delete those resources first if you mean to.

Path Parameters
tenant_id uuid — REQUIRED Tenant identifier

Responses
200 Tenant deleted
403 Caller is not a platform owner Schema — OPTIONAL details Detailed error metadata. The contents of this field is determined by error_code. error_code string Error code is a string that specifies this error type. message string Human-readable error message.
404 No tenant with that identifier Schema — OPTIONAL details Detailed error metadata. The contents of this field is determined by error_code. error_code string Error code is a string that specifies this error type. message string Human-readable error message.
409 The tenant still holds pipelines, API keys or OIDC trust relationships Schema — OPTIONAL details Detailed error metadata. The contents of this field is determined by error_code. error_code string Error code is a string that specifies this error type. message string Human-readable error message.
500 Schema — OPTIONAL details Detailed error metadata. The contents of this field is determined by error_code. error_code string Error code is a string that specifies this error type. message string Human-readable error message.