> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxenty.api.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciar Participantes

> Adiciona, remove, promove ou rebaixa participantes

Gerencia os participantes de um grupo. Requer permissões de administrador.

## Adicionar Participantes

<api method="POST" path="/api/groups/participants/add" />

Adiciona novos participantes ao grupo.

<ParamField body="sessionId" type="string" required>
  ID da sessão.
</ParamField>

<ParamField body="groupJid" type="string" required>
  JID do grupo.
</ParamField>

<ParamField body="participants" type="string[]" required>
  Lista de JIDs para adicionar.
</ParamField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X POST "https://api.oxenty.api.br/api/groups/participants/add" \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
      "groupJid": "120363123456789012@g.us",
      "participants": ["5511666666666@s.whatsapp.net"]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "success": true,
    "results": [
      {
        "jid": "5511666666666@s.whatsapp.net",
        "status": "added"
      }
    ]
  }
  ```
</ResponseExample>

***

## Remover Participantes

<api method="POST" path="/api/groups/participants/remove" />

Remove participantes do grupo.

```bash theme={"system"}
curl -X POST "https://api.oxenty.api.br/api/groups/participants/remove" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "groupJid": "120363123456789012@g.us",
    "participants": ["5511666666666@s.whatsapp.net"]
  }'
```

***

## Promover a Admin

<api method="POST" path="/api/groups/participants/promote" />

Promove participantes a administradores.

```bash theme={"system"}
curl -X POST "https://api.oxenty.api.br/api/groups/participants/promote" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "groupJid": "120363123456789012@g.us",
    "participants": ["5511888888888@s.whatsapp.net"]
  }'
```

***

## Rebaixar Admin

<api method="POST" path="/api/groups/participants/demote" />

Rebaixa administradores a participantes comuns.

```bash theme={"system"}
curl -X POST "https://api.oxenty.api.br/api/groups/participants/demote" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "groupJid": "120363123456789012@g.us",
    "participants": ["5511888888888@s.whatsapp.net"]
  }'
```

***

## Possíveis Status de Resultado

| Status             | Descrição                            |
| ------------------ | ------------------------------------ |
| `added`            | Participante adicionado com sucesso  |
| `removed`          | Participante removido com sucesso    |
| `promoted`         | Promovido a admin                    |
| `demoted`          | Rebaixado de admin                   |
| `already_in_group` | Já é participante                    |
| `not_in_group`     | Não está no grupo                    |
| `blocked`          | Participante bloqueou você           |
| `privacy`          | Configurações de privacidade impedem |