> ## 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.

# Editar lista de transmissão

> Edita uma lista de transmissão existente no WhatsApp

## Conceituação

Neste método você pode editar uma lista de transmissão já existente, alterando o nome e/ou os números que a compõem.

<Warning>
  Atente-se às limitações e regras do uso de listas de transmissão. Para mais detalhes, consulte a [introdução](/broadcast/introduction).
</Warning>

***

## 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>

### Path

<ParamField path="broadcastId" type="string" required>
  ID da lista de broadcast a ser editada. Ex: 1779474934\@broadcast
</ParamField>

### Opcionais

<ParamField body="name" type="string">
  Novo nome da lista de transmissão
</ParamField>

### Obrigatórios

<ParamField body="phones" type="array" required>
  Lista completa de números dos destinatários no formato E.164 sem o `+`. Ex: 5511999999999
</ParamField>

<Info>
  O campo `phones` **substitui a lista atual por completo** a cada requisição. Por isso:

  * Para **adicionar** um novo contato, envie todos os números já existentes na lista mais o novo.
  * Para **remover** um contato, envie todos os números existentes, omitindo apenas os que deseja remover.
</Info>

***

## Request Body

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "name": "Nome da lista",
  "phones": ["5511999999999", "5511888888888"]
}
```

***

## Response

### 200

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "broadcastId": "1778158856@broadcast",
  "name": "Teste de broadcast editado",
  "phones": [
    "5511999999999",
    "5511888888888",
    "5511777777777"
  ]
}
```

### 405

Neste caso certifique que esteja enviando corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET 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".