> ## Documentation Index
> Fetch the complete documentation index at: https://developer.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Deletar mensagens

> Apaga uma mensagem enviada ou recebida em um chat

## Conceituação

Método utilizado para apagar uma mensagem em um chat, você pode deletar tanto uma mensagem que enviou quanto uma mensagem enviada por um contato, para utilizar este recurso você só vai precisar do messageId da mensagem que quer apagar.

#### Exemplo no WhatsApp

<div style={{ display: "flex", justifyContent: "center" }}>
  <img src="https://mintcdn.com/z-api-8aa3bb40/4dxajBiLV0HF17QH/images/delete-message.jpeg?fit=max&auto=format&n=4dxajBiLV0HF17QH&q=85&s=0a87a78913491b2b2f93a61c8569101e" width="400" data-path="images/delete-message.jpeg" />
</div>

***

## Atributos

### Header

<ParamField path="instanceId" type="string" required>
  ID da sua instância. Disponível no painel Z-API em **Instâncias**.
</ParamField>

<ParamField path="token" type="string" required>
  Token da sua instância Z-API.
</ParamField>

### Query Parameters

<ParamField query="messageId" type="string" required>
  ID original da mensagem
</ParamField>

<ParamField query="phone" type="string" required>
  Telefone (ou ID do grupo para casos de envio para grupos) do destinatário/remetente no formato DDI DDD NÚMERO. Ex: 551199999999
</ParamField>

<ParamField query="owner" type="boolean" required>
  Informe `true` caso você tenha enviado a mensagem ou `false` para casos onde seja uma mensagem recebida
</ParamField>

## Exemplo de requisição

### URL exemplo

```bash theme={"theme":{"light":"github-light","dark":"poimandres"}}
DELETE https://api.z-api.io/instances/{instanceId}/token/{instanceToken}/messages?messageId=123&phone=5511999998888&owner=true
```

***

## Response

### 204

No content

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{}
```

### 405

Neste caso certifique que esteja enviando corretamente a especificação do método, ou seja verifique se você enviou o DELETE conforme especificado no início deste tópico.

### 415

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json".