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

# Atualizar grupo de signatários

> Edita o nome e a lista de membros de um grupo (substitui completamente).

Atualiza um grupo de signatários, substituindo completamente o nome e a lista de membros. A operação é "tudo ou nada" — a lista inteira de contatos é refeita.

**Autenticação**: `x-api-key` no header. Também aceita `Authorization: Bearer`.

## Parâmetros

<ParamField path="uuid" type="string" required>
  UUID do grupo.
</ParamField>

<ParamField body="name" type="string" required>
  Novo nome do grupo.
</ParamField>

<ParamField body="contactUuids" type="array" required>
  Nova lista de contatos (substitui completamente a anterior). Mínimo 1.
</ParamField>

## Respostas

Retorna o objeto do grupo atualizado.

## Erros

Veja [Autenticação e erros](/plataforma/assinatura-digital/api/erros-e-autenticacao).

* **400**: Lista vazia, ou contato não pertence à agenda.
* **404**: Grupo não encontrado ou não pertence ao seu projeto.
* **409**: Novo nome já existe em outro grupo.

<ResponseExample>
  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 200 OK
  Content-Type: application/json

  {
    "uuid": "6ba7b820-9dad-11d1-80b4-00c04fd430c9",
    "name": "Diretoria Executiva",
    "members": [
      {
        "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "name": "João Silva",
        "cpf": "12345678901",
        "email": "joao@empresa.com"
      }
    ],
    "updatedAt": "2025-07-27T15:00:00Z"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X PUT "https://api.valid.com/signer/v1/signer-contact-groups/6ba7b820-9dad-11d1-80b4-00c04fd430c9" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Diretoria Executiva",
    "contactUuids": [
      "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
    ]
  }'
```

## Importante

* **Substitui completamente**: a lista anterior é descartada, use a nova lista.
* **Soft-delete de membros**: os membros removidos são marcados como deletados no banco (não aparecem mais nas buscas), mas históricos são preservados.

## Relacionado

* [`GET .../signer-contact-groups`](/plataforma/assinatura-digital/api/get-signer-contact-groups) — listar grupos
* [`DELETE .../signer-contact-groups/:uuid`](/plataforma/assinatura-digital/api/delete-signer-contact-group) — remover grupo


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.