# Gerenciar grupos em uma comunidade

`POST /community/editgroups`

Pasta: **Grupos e Comunidades**

## Autenticação

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

## Descrição

# Vincular ou desvincular grupo da comunidade

Associa (`link`/`add`) ou remove (`unlink`/`remove`) **um** grupo filho de uma comunidade. Exige ser admin da comunidade.

## Endpoint

`POST {{baseUrl}}/community/editgroups`

## Autenticação

Envie o token da instância no header:

`token: {{token}}`

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| parent | string | Condicional | JID da comunidade |
| parentJid | string | Condicional | Alias de `parent` |
| communityJid | string | Condicional | Alias de `parent` |
| child | string | Condicional | JID do grupo a vincular/desvincular |
| childJid | string | Condicional | Alias de `child` |
| groupJid | string | Condicional | Alias de `child` |
| action | string | Sim | `link` ou `unlink` (aliases: `add` / `remove`) |

### Ações

| action | Alias | Efeito |
| --- | --- | --- |
| `link` | `add` | Vincula o grupo à comunidade |
| `unlink` | `remove` | Remove o vínculo |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/community/editgroups" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "parent": "120363153742561022@g.us",
  "child": "120363324255083289@g.us",
  "action": "link"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "action": "link",
  "parent": "120363153742561022@g.us",
  "child": "120363324255083289@g.us"
}
```

## Erros comuns

- Informe o JID da comunidade (`parent`/`parentJid`/`communityJid`).
- Informe o JID do grupo (`child`/`childJid`/`groupJid`).
- `action` fora de `link`/`unlink`/`add`/`remove`.
- Sem permissão de admin na comunidade.

## Observações

- A operação é **um grupo por requisição** (não envie array `groupjids`).
- Desvincular não apaga o grupo — só remove o vínculo com a comunidade.

## Corpo (exemplo)

```json
{
  "parent": "120363153742561022@g.us",
  "child": "120363324255083289@g.us",
  "action": "link"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/community/editgroups" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "parent": "120363153742561022@g.us",
  "child": "120363324255083289@g.us",
  "action": "link"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=grupos-e-comunidades/gerenciar-grupos-em-uma-comunidade)