> ## 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.

# Atualizar Assunto

> Atualiza o nome (assunto) de um grupo

Atualiza o nome de um grupo WhatsApp. Você precisa ser admin do grupo.

## Request Body

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

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

<ParamField body="subject" type="string" required>
  Novo nome do grupo (máximo 25 caracteres).
</ParamField>

## Resposta

<ResponseField name="success" type="boolean">
  Se o assunto foi atualizado.
</ResponseField>

<ResponseField name="groupJid" type="string">
  JID do grupo.
</ResponseField>

<ResponseField name="setting" type="string">
  Configuração alterada (`subject`).
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X PUT "https://api.oxenty.api.br/api/groups/subject" \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
      "groupJid": "123456789@g.us",
      "subject": "Suporte Oxenty 🚀"
    }'
  ```

  ```typescript TypeScript theme={"system"}
  await client.groups.updateSubject({
    sessionId: '550e8400-e29b-41d4-a716-446655440000',
    groupJid: '123456789@g.us',
    subject: 'Suporte Oxenty 🚀',
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "success": true,
    "groupJid": "123456789@g.us",
    "setting": "subject"
  }
  ```
</ResponseExample>

***

## Atualizar Descrição

<api method="PUT" path="/api/groups/description" />

Atualiza a descrição de um grupo.

```bash theme={"system"}
curl -X PUT "https://api.oxenty.api.br/api/groups/description" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "groupJid": "123456789@g.us",
    "description": "Grupo oficial de suporte da Oxenty API"
  }'
```

***

## Atualizar Configurações

<api method="PUT" path="/api/groups/settings" />

Atualiza configurações do grupo (modo anúncio, quem pode editar).

```bash theme={"system"}
curl -X PUT "https://api.oxenty.api.br/api/groups/settings" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "groupJid": "123456789@g.us",
    "setting": "announcement"
  }'
```

**`Valores de setting:`**

* `announcement` - Apenas admins podem enviar mensagens
* `not_announcement` - Todos podem enviar mensagens
* `locked` - Apenas admins podem editar info do grupo
* `unlocked` - Todos podem editar info do grupo