# Atualizar imagem do grupo

`POST /group/updateImage`

Pasta: **Grupos e Comunidades**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Atualizar imagem do grupo

Define ou remove a foto do grupo. Aceita URL pública, Base64/data-URI, ou `remove`/`delete`/vazio para limpar.

## Endpoint

`POST {{baseUrl}}/group/updateImage`

## Autenticação

Envie o token da instância no header:

`token: {{token}}`

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| jid | string | Sim | JID do grupo (`...@g.us`) |
| image | string | Sim | URL, Base64/data-URI, ou `remove`/`delete` para remover |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/group/updateImage" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "jid": "120363308883996631@g.us",
  "image": "https://meusite.com/imagem.jpg"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "picture_id": "1234567890",
  "image_updated": true,
  "image_removed": false
}
```

## Erros comuns

- `jid` obrigatório.
- Imagem inválida ou inacessível.
- Exige ser administrador do grupo.
- Instância desconectada ou token inválido.

## Observações

- O campo correto é `jid` (não `groupjid`).
- Na remoção, `picture_id` costuma ser `remove` e `image_removed` fica `true`.

## Corpo (exemplo)

```json
{
  "jid": "120363308883996631@g.us",
  "image": "https://meusite.com/imagem.jpg"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/group/updateImage" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "jid": "120363308883996631@g.us",
  "image": "https://meusite.com/imagem.jpg"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=grupos-e-comunidades/atualizar-imagem-do-grupo)