Messages

Download inbound message media

Returns the binary payload of an inbound WhatsApp media message. WUTS serves warm-cached bytes when available and otherwise re-downloads the media on demand over the live whatsmeow socket, requesting retransmission from the sender when the WhatsApp CDN copy has expired.

GET
/messages/{id}/media

Returns the binary payload of an inbound WhatsApp media message. WUTS serves warm-cached bytes when available and otherwise re-downloads the media on demand over the live whatsmeow socket, requesting retransmission from the sender when the WhatsApp CDN copy has expired.

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

WhatsApp message id whose media should be retrieved. Resolved device-agnostically within the tenant.

Response Body

application/octet-stream

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/messages/string/media"
"string"
{  "success": false,  "status": "retry_requested"}
{  "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"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Edit a previously sent message PUT

Replaces the text content of a message already sent from the WUTS-connected device. WhatsApp only allows editing within a limited time window after the original message was sent.

Get message delivery status GET

Returns the aggregated delivery status of an outbound message sent by the connected device: pending (sent, no receipt yet) -> delivered -> read -> played. Backed by persisted WhatsApp receipts. For group messages the timestamps reflect the first/any participant.