> For the complete documentation index, see [llms.txt](https://docs.zapfy.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zapfy.me/integrando-com-a-api/grupos/alterar-membros-de-um-grupo.md).

# Alterar membros de um grupo

Permite alterar membros do grupo (permissionamento).

###

### Exemplo de body a ser enviado:

O parâmetro `action` possui quatro valores, sendo cada um deles representando uma ação.

* `add` - Adiciona membros no grupo.
* `promote` - Promove membros do grupo à administradores.
* `demote` - Promove membros do grupo à membros comuns.
* `remove` - Remove membros do grupo.

```
{
    "groupId": "120363026267511334@g.us",
    "action": "add",
    "participants": ["5527997320619"]
}
```

## Alterar membros de um grupo

<mark style="color:green;">`POST`</mark> `https://api.zapfy.me/v1/instance/{{instanceKey}}/token/{{instanceToken}}/groupParticipantsUpdate`

#### Path Parameters

| Name                                            | Type   | Description                       |
| ----------------------------------------------- | ------ | --------------------------------- |
| instanceKey<mark style="color:red;">\*</mark>   | String | Key de identificação da instância |
| instanceToken<mark style="color:red;">\*</mark> | String | Token de acesso da instância      |

#### Request Body

| Name                                           | Type      | Description                                                                                                                                                                                                                                               |
| ---------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| groupId<mark style="color:red;">\*</mark>      |           | Id do grupo                                                                                                                                                                                                                                               |
| action<mark style="color:red;">\*</mark>       | String    | <p><code>add</code> - Adiciona membros no grupo.</p><p><code>promote</code> - Promove membros do grupo à administradores.</p><p><code>demote</code> - Promove membros do grupo à membros comuns.</p><p><code>remove</code> - Remove membros do grupo.</p> |
| participants<mark style="color:red;">\*</mark> | String\[] | Array de string contendo os participantes a serem modificados                                                                                                                                                                                             |

{% tabs %}
{% tab title="200: OK Contato conectado na instância agora faz parte do grupo" %}

```javascript
{
    "result": [
        {
            "status": "200",
            "jid": "5527997320619@s.whatsapp.net"
        }
    ],
    "isValid": true
}
```

{% endtab %}
{% endtabs %}