Status

Update status privacy rules

Updates who can view statuses on the connected WUTS WhatsApp session. Use type 'contacts' for all contacts (list ignored), 'whitelist' to allow only the listed contacts, or 'blacklist' to exclude the listed contacts.

PUT
/status/privacy

Updates who can view statuses on the connected WUTS WhatsApp session. Use type 'contacts' for all contacts (list ignored), 'whitelist' to allow only the listed contacts, or 'blacklist' to exclude the listed contacts.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/status/privacy" \  -H "Content-Type: application/json" \  -d '{    "type": "blacklist",    "list": [      "5511999999999@s.whatsapp.net"    ]  }'
{  "success": true,  "type": "blacklist",  "count": 1,  "list": [    "5511999999999@s.whatsapp.net"  ]}
{  "success": false,  "error": {    "code": "invalid_request",    "message": "list cannot be empty for whitelist"  }}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": {    "code": "device_error",    "message": "failed to resolve user device"  }}
{  "success": false,  "error": {    "code": "privacy_update_failed",    "message": "failed to update status privacy"  }}
{  "success": false,  "error": {    "code": "device_disconnected",    "message": "whatsapp session is not connected"  }}
{  "success": false,  "error": {    "code": "privacy_update_timeout",    "message": "info query timed out"  }}

Publish a text status POST

Publishes a text-only status broadcast to the connected WUTS WhatsApp session. The text is delivered to the WhatsApp Status broadcast channel and visible according to the session's current status privacy rules.

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.