Skip to main content
PUT
Atualizar grupo de signatários
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

string
required
UUID do grupo.
string
required
Novo nome do grupo.
array
required
Nova lista de contatos (substitui completamente a anterior). Mínimo 1.

Respostas

Retorna o objeto do grupo atualizado.

Erros

Veja Autenticação e erros.
  • 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.

Exemplo

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