# Alterar configurações de privacidade

`POST /instance/privacy`

Pasta: **Instancia**

## Autenticação

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

## Descrição

# Alterar configurações de privacidade

Altera **uma** configuração de privacidade por chamada e devolve o conjunto atualizado.

Use para restringir quem vê último acesso, foto, status, etc.

## Endpoint

```http
POST {{baseUrl}}/instance/privacy
```

## Autenticação

Header da instância:

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

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `name` | string | Sim* | Tipo da configuração. Alias: `type`. Valores: `groupadd`, `last`, `status`, `profile`, `readreceipts`, `online`, `calladd`, `messages`, `defense`, `stickers`. |
| `value` | string | Sim | Novo valor. Exemplos: `all`, `contacts`, `contact_blacklist`, `none`, `known`, `match_last_seen` (depende do `name`). |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/instance/privacy" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "last",
  "value": "contacts"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "privacy": {
    "GroupAdd": "contacts",
    "LastSeen": "contacts",
    "Status": "contacts",
    "Profile": "contacts",
    "ReadReceipts": "all"
  }
}
```

## Erros comuns

- `401` — header `token` ausente ou inválido
- `400` — JSON inválido
- `500` — valor/`name` rejeitado pelo WhatsApp ou sessão offline

## Observações

*Se `name` estiver vazio, a API usa `type`. Não envie várias chaves de privacidade no mesmo body — o handler aceita apenas `name`/`type` + `value`.

## Corpo (exemplo)

```json
{
  "name": "last",
  "value": "contacts"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/instance/privacy" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "last",
  "value": "contacts"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=instancia/alterar-configuracoes-de-privacidade)