MEmeta
Media

Delete Media

To delete media, make a DELETE call to the ID of the media you want to delete.

Prerequisites

  • User Access Token with whatsapp_business_messaging permission
  • Media object ID from either uploading media endpoint or media message Webhooks
delete/{Version}/{Media-ID}

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Media-ID}
  • Auth
    HTTP bearer

Query parameters

phone_number_idstring
Example:<PHONE_NUMBER_ID>

Specifies that deletion of the media only be performed if the media belongs to the provided phone number.

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Content-Type'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data' required
Example:application/json

Media type of the request body

Response

Delete Media

successboolean

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 5 revisions of this API.