Skip to content

Delete tenant

Request to delete a tenant:

DELETE /api/v2/tenants/<tenant-id>.json

The tenant must have no users. Delete or move the users first.

Response contains HTTP status code as shown in the following table.

Response Description
200 OK The tenant has been successfully deleted
403 Forbidden The request cannot be completed because API user has no permission to delete tenants
404 Not Found The ID is not a valid UUID
409 Conflict

The tenant still has users:

{"error": "NotEmptyError", "explanation": "Other resources refer to this one", "details": "Cannot delete a tenant, which has users"}