Users and admin

Delete a tenant permanently

Permanently removes a WUTS tenant and CASCADE-deletes all of its related data (users, devices, sessions and more). This is a destructive, irreversible master-token-only operation and is logged as a critical event.

DELETE
/global/tenants/{id}

Permanently removes a WUTS tenant and CASCADE-deletes all of its related data (users, devices, sessions and more). This is a destructive, irreversible master-token-only operation and is logged as a critical event.

Authorization

masterToken
AuthorizationBearer <token>

Platform master token sent as Authorization: Bearer <master-token>. Required only for Super Admin (cross-tenant) endpoints.

In: header

Path Parameters

id*string

Unique identifier of the tenant to delete.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/global/tenants/string"
{  "success": true,  "message": "Tenant and all related data permanently deleted",  "data": {    "tenant_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",    "tenant_name": "Acme Atendimento",    "deleted_at": "2026-06-15T12:05:00Z"  }}
{  "success": false,  "error": "tenant ID is required"}
{  "success": false,  "error": "invalid master token"}
{  "success": false,  "error": "tenant not found"}
{  "success": false,  "error": "failed to delete tenant"}

Change a user's role POST

Promotes or demotes a WUTS user to a new role. The caller must have permission for the specific role transition; the response echoes the old and new roles.

Get tenant details GET

Fetches the details of a single WUTS tenant by its unique identifier. Restricted to platform operators holding the master token.