# WhatsApp Cloud API - Media API | Developer Documentation

<div id="bkmrk-whatsapp-cloud-api--"><div><div>## WhatsApp Cloud API - Media API

<div><div><div><span>Copy for LLM</span></div></div><div>[<span>View as Markdown</span>](/books/meta-whatsapp/page/whatsapp-cloud-api-media-api-developer-documentation)</div></div></div><div><div>Version</div></div><div></div><div><div><div><div><span></span><div><div><span><span>Retrieve and delete uploaded media files by media ID.</span></span></div></div><div><div><span><span>Get media URLs with file metadata including size, MIME type, and SHA256 hash.</span></span></div></div><div><div><span><span>Media URLs are valid for 5 minutes after retrieval.</span></span></div></div></div></div></div></div></div><div><div>---

<div><div></div><div><div><div><div><div><div><div>Select language</div></div><div></div></div></div>---

<div></div></div><div><div><div><div><div><div>Select status code</div></div><div></div></div></div>---

<div></div></div></div></div></div></div></div><div>---

<div><div><div id="bkmrk-delete-%2F%7Bversion%7D%2F%7Bm"><div id="bkmrk-delete-%2F%7Bversion%7D%2F%7Bm-1"><div>### DELETE /{Version}/{Media-ID}

</div></div></div><div><div><div><div><span></span><div><div><span><span>To delete media, make a </span></span><span><span>DELETE</span></span><span><span> call to the ID of the media you want to delete.</span></span></div></div>
<div><div><div id="bkmrk-prerequisites-1"><div id="bkmrk-prerequisites-2"><div>### Prerequisites

</div></div></div></div></div><span></span><div>[<span><span>User Access Token</span></span>](https://developers.facebook.com/docs/facebook-login/access-tokens#usertokens)<span><span> with </span></span>`<span><span>whatsapp_business_messaging</span></span>`<span><span> permission</span></span></div><div><span><span>Media object ID from either uploading media endpoint or media message Webhooks</span></span></div></div></div></div></div><div><span>Responses</span>---

<div><div><div><div><span></span><div><div><span><span>To delete media, make a </span></span><span><span>DELETE</span></span><span><span> call to the ID of the media you want to delete.</span></span></div></div>
<div><div><div id="bkmrk-prerequisites-5"><div id="bkmrk-prerequisites-6"><div>### Prerequisites

</div></div></div></div></div><span></span><div>[<span><span>User Access Token</span></span>](https://developers.facebook.com/docs/facebook-login/access-tokens#usertokens)<span><span> with </span></span>`<span><span>whatsapp_business_messaging</span></span>`<span><span> permission</span></span></div><div><span><span>Media object ID from either uploading media endpoint or media message Webhooks</span></span></div></div></div></div></div><div><span>200</span><div><div><div><div><span></span><div><div><span><span>Delete Media</span></span></div></div></div></div></div></div><div><div><span>Content Type: </span><span>application/json</span></div><div><div><span>Schema: </span><span>object</span></div><div><div><div id="bkmrk-show-child-attribute-1"><div><span>Show child attributes</span></div></div><div id="bkmrk-successboolean"><div><div>---

<div><div><span>success</span><span>boolean</span></div></div></div></div></div></div></div></div></div></div></div></div><div><div><div><div><div><div><div>Select language</div></div><div></div></div></div>---

<div></div></div><div><div><div><div><div><div>Select status code</div></div><div></div></div></div>---

<div></div></div></div></div></div></div></div></div><div><div id="bkmrk-authentication"><div id="bkmrk-authentication-1"><div>### Authentication

</div></div></div><div><table><tbody><tr><td><div>**Scheme**</div></td><td><div>**Type**</div></td><td><div>**Location**</div></td></tr><tr><td><div><div><div><div><div><span></span><div><div><span><span>bearerAuth</span></span></div></div></div></div></div></div></div></td><td><div><div><div><div><div><span></span><div><div><span><span>HTTP Bearer</span></span></div></div></div></div></div></div></div></td><td><div><div><div><div><div><span></span><div><div><span><span>Header: </span></span>`<span><span>Authorization</span></span>`</div></div></div></div></div></div></div></td></tr></tbody></table>

</div><div>#### Usage Examples

<div><span>bearerAuth:</span><span></span><div><div><div><div><span></span><div><div><span><span>Include </span></span>`<span><span>Authorization: Bearer your-token-here</span></span>`<span><span> in request headers</span></span></div></div></div></div></div></div></div></div><div>#### Global Authentication Requirements

<div><span>All endpoints require:</span><div><div><div><div><span></span><div><div><span><span>bearerAuth</span></span></div></div></div></div></div></div></div></div></div></div>