# Definir privacidade do status

`POST /status/privacy`

Pasta: **Status**

## Autenticação

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

## Descrição

# Definir privacidade do status

Atualiza quem pode ver seus status/stories por padrão. Use `contacts`, `whitelist` ou `blacklist`.

## Endpoint

`POST {{baseUrl}}/status/privacy`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `type` | string | Sim | `contacts`, `whitelist` (aliases: `allowlist`, `allow`) ou `blacklist` (aliases: `denylist`, `deny`, `except`). |
| `jids` | string[] | Condicional | Lista de JIDs/números; obrigatória na prática para `whitelist`/`blacklist`. |
| `list` | string[] | Não | Alias de `jids` (usado se `jids` estiver vazio). |

Nota: envie `jids` (ou `list`) quando `type` for `whitelist` ou `blacklist`.

## Exemplo de Requisição

```bash
curl --request POST '{{baseUrl}}/status/privacy' \
  --header 'token: {{token}}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "type": "blacklist",
  "jids": [
    "5511999999999@s.whatsapp.net",
    "5511888888888@s.whatsapp.net"
  ]
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "privacy": [
    {
      "Type": "blacklist",
      "List": [
        "5511999999999@s.whatsapp.net",
        "5511888888888@s.whatsapp.net"
      ]
    }
  ]
}
```

## Erros comuns

- `401 Unauthorized`: o header `token` não foi enviado ou é inválido.
- `400 Bad Request`: `type` ausente ou inválido.
- `500 Internal Server Error`: tipo inválido no serviço, JID inválido ou cliente indisponível.

## Observações

- Esta rota **não** exige modo mobile.

## Corpo (exemplo)

```json
{
  "type": "blacklist",
  "jids": [
    "5511999999999@s.whatsapp.net",
    "5511888888888@s.whatsapp.net"
  ]
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/status/privacy" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "blacklist",
  "jids": [
    "5511999999999@s.whatsapp.net",
    "5511888888888@s.whatsapp.net"
  ]
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=status/definir-privacidade-do-status)