Users and admin

List users (admin)

Lists all WUTS platform users within the admin's tenant. Requires the caller to hold the admin role; the tenant is resolved from the bearer token.

GET
/users

Lists all WUTS platform users within the admin's tenant. Requires the caller to hold the admin role; the tenant is resolved from the bearer token.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/users"
{  "success": true,  "users": [    {      "id": "9b1c7e2a-44d3-4a55-8f10-2b3c4d5e6f70",      "tenant_id": "1a2b3c4d-5e6f-4071-8293-a4b5c6d7e8f9",      "email": "owner@example.com",      "role": "admin",      "token": "8f7e6d5c-4b3a-4921-90af-1e2d3c4b5a60",      "active": true,      "created_at": "2026-06-01T09:00:00Z",      "updated_at": "2026-06-10T11:30: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"}

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.

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.