Publish an image or video status

Uploads and publishes an image or video status broadcast through the connected WUTS WhatsApp session. Provide the media either inline as base64 in the data field or as a downloadable url; when media_type is omitted it is inferred from mime_type.

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.

Image or video status payload. Provide media via 'data' (base64) or 'url'.

media_type?string

Kind of media to publish. When omitted it is inferred from mime_type. Accepted values include image (or photo) and video.

mime_type?string

MIME type of the media. When omitted it is auto-detected from the media bytes (e.g. image/jpeg, video/mp4).

data?string

Standard base64-encoded media bytes. Mutually used with url; either data or url must be provided.

url?string

Downloadable URL of the media. Used when data is not provided; either data or url must be provided.

caption?string

Optional caption shown beneath the image or video status.

view_once?boolean

When true the status media is marked as view-once.

Response Body

`application/json`

curl -X POST "https://example.com/status/media" \  -H "Content-Type: application/json" \  -d '{    "media_type": "image",    "mime_type": "image/jpeg",    "url": "https://cdn.example.com/promos/today.jpg",    "caption": "Flash sale ends tonight!",    "view_once": false  }'

{  "success": true,  "message_id": "3EB0XXXX1234567890ABCDEF",  "timestamp": "2026-06-15T14:35:11-03:00",  "status_type": "image",  "mime_type": "image/jpeg"}

{  "success": false,  "error": {    "code": "invalid_media",    "message": "either data or url must be provided"  }}

{  "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": "upload_failed",    "message": "failed to upload media to whatsapp"  }}

{  "success": false,  "error": {    "code": "device_disconnected",    "message": "whatsapp session is not connected"  }}

{  "success": false,  "error": {    "code": "upload_timeout",    "message": "context deadline exceeded"  }}

Publish an image or video status

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

500application/json

502application/json

503application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`