Users and admin

Delete a user

Permanently deletes a WUTS user. Callers cannot delete their own account and must have permission to manage the target user within the same tenant.

DELETE
/users/{id}

Permanently deletes a WUTS user. Callers cannot delete their own account and must have permission to manage the target user within the same tenant.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Path Parameters

id*string

Identifier of the user to delete.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/users/string"
{  "success": true,  "message": "User permanently deleted"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Create a user (admin) POST

Creates a new WUTS platform user inside the admin's tenant. Requires the admin role; the new user inherits the caller's tenant and receives an API token. An optional webhook URL can be supplied for later device configuration.

Get a user GET

Returns the details of a single WUTS user. The caller must have permission to manage the target user (same tenant plus a sufficient role); super-admins may view any user.