---
title: "Delete media by media ID"
method: DELETE
path: "/partner/app/{appId}/media/{mediaId}"
tags: ["Media Management"]
---

# Delete media by media ID

`DELETE /partner/app/{appId}/media/{mediaId}`

Permanently deletes a media file from WhatsApp servers using the mediaId. Once deleted, the operation cannot be undone.

## Path parameters

- `appId` string, uuid, required
- `mediaId` string, required

## Headers

- `token` string, required

## Response `200`

Successful deletion

- object
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request - Invalid ID or blocked delete operation
- `401` — Unauthorized - Invalid or missing token
- `403` — Forbidden - No permission to perform delete
- `404` — Not Found - MediaId not found
- `429` — Too Many Requests - Rate Limit applied
- `500` — Internal Server Error

---

[API](https://skmtc.net/gupshup/apis/partner-portal-public-apis.md) · [All operations](https://skmtc.net/gupshup/apis/partner-portal-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupshup/partner-portal-public-apis/revisions/1846573c8f87/schema)