Delete a tenant

DELETE 
/v1/organizations/:organization_id/tenants/:tenant_id

Delete an existing tenant and deactivate the related organization. A tenant from the user's own organization cannot be deleted. A tenant cannot be deleted if the organization has more than one tenant.

Request

Responses

204

Tenant deleted successfully. The related organization has been deactivated. No content is returned in the response body.

400

Invalid request. Common causes: - Invalid path parameters - Invalid tenant ID format

401

Unauthorized: authentication required or user does not have permissions to delete the tenant. Also returned when attempting to delete a tenant from the user's own organization.

404

Tenant not found

422

Unprocessable entity: business logic validation error. Common causes: - Cannot delete a tenant with sub-tenants (organization has more than one tenant) - Cannot delete a tenant from its own organization

429

Too Many Requests

500

Internal Server Error