API Reference
WhatsApp Messaging

Delete media

DELETE
/v1/whatsapp/media/{id}

Deletes an uploaded media object at Meta.

Meta's reference: https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media

API-key scope: whatsapp.messages.

Authorization

bearerAuth
AuthorizationBearer <token>

Long-lived ES256 JWT minted from the dashboard (https://app.sautikit.com/developers/api-keys). Signed by the platform keyring. Carries workspace_id and scopes claims; revoked via the platform deny-list.

In: header

Path Parameters

id*string

Meta's media id, as carried on an inbound message (e.g. image.id).

Query Parameters

number_id?string

The Sautikit number the media belongs to. Mutually exclusive with connection_id.

Formatuuid
connection_id?string

The WhatsApp connection the media belongs to. Mutually exclusive with number_id.

Formatuuid

Response Body

application/json

application/json

curl -X DELETE "https://example.com/v1/whatsapp/media/string"
{  "success": true}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string",    "details": [      "string"    ],    "resolution": "string",    "reason": "invalid_characters",    "suggested_e164": "+254720000003"  }}