> ## Documentation Index
> Fetch the complete documentation index at: https://developers.datafyapi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Deletar mídia

> Remova da Meta uma mídia enviada pelo upload.

Remove da Meta uma mídia que você enviou com o [Upload de mídia](https://developers.datafyapi.com.br/api-reference/whatsapp/recursos/midia/upload-de-midia.md). A resposta é `{ "success": true }`.

Sem essa chamada, a mídia é apagada sozinha **30 dias** depois do upload.

> [!NOTE]
>
> Apagar a mídia impede novos envios com aquele `id`. As mensagens que já foram enviadas com ela não são afetadas.

O parâmetro opcional `phone_number_id` faz a Meta processar a remoção só quando a mídia pertence àquele número.

Veja mais detalhes na [documentação de mídia da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media).


## OpenAPI

````yaml api-reference/whatsapp/specs/deletar-midia.json DELETE /v1/{media_id}
openapi: 3.1.0
info:
  title: Datafy API — Deletar mídia
  version: 1.0.0
servers:
  - url: https://cloud.datafyapi.com.br
    description: Produção
security:
  - bearerAuth: []
paths:
  /v1/{media_id}:
    delete:
      summary: Deletar mídia
      description: >-
        Espelho de `DELETE /{media_id}` da Meta Cloud API. Remove da Meta uma
        mídia enviada pelo upload.
      operationId: deletarMidia
      parameters:
        - name: media_id
          in: path
          required: true
          schema:
            type: string
          description: ID da mídia retornado pelo upload.
        - name: phone_number_id
          in: query
          required: false
          schema:
            type: string
          description: >-
            Opcional. Se informado, a Meta só processa a requisição quando a
            mídia pertence a esse número.
      responses:
        '200':
          description: Mídia removida.
          content:
            application/json:
              example:
                success: true
        '400':
          description: Erro retornado pela Meta, como ID inválido ou já removido.
          content:
            application/json:
              example:
                error:
                  message: (#100) Invalid parameter
                  type: OAuthException
                  code: 100
                  fbtrace_id: AbCdEfGhIjK
        '401':
          description: Token ausente ou inválido.
          content:
            application/json:
              example:
                statusCode: 401
                message: Token inválido ou não encontrado.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token gerado no painel da Datafy ao criar o canal. Formato:
        `sk_live_xxx`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.