Users and admin

Get a user

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.

GET
/users/{id}

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.

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 retrieve.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/users/string"
{  "success": true,  "data": {    "id": "7c2d1e3f-9a8b-4c10-b2d3-e4f5a6b7c8d9",    "email": "agent@example.com",    "role": "user",    "active": true,    "tenant_id": "1a2b3c4d-5e6f-4071-8293-a4b5c6d7e8f9",    "created_at": "2026-06-15T14:00:00Z",    "updated_at": "2026-06-15T14: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"}

Delete a user DELETE

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

List users (admin) GET

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.