Endpoint: PUT/PATCH /user/groups/{id}/
Autenticação: JWT obrigatório
Atualiza o name e/ou as permissions do grupo. Quando permissions é informado, as permissões do grupo são totalmente substituídas pela nova lista (é uma operação de definição, não de adição). Quando permissions é omitido, o conjunto atual é preservado. O grupo de identificador 1 recebe tratamento especial: tentativas de renomeá-lo são silenciosamente descartadas (o campo name é removido dos dados validados antes de salvar). Ainda assim, é possível alterar as suas permissões.

​
Pré-requisitos

  • O grupo precisa existir.
  • Quem faz a chamada precisa ser superusuário ou possuir a permissão auth.manage_groups.

​
Parâmetros de rota

​
id
integer
required
Identificador do grupo.

​
Corpo da requisição

​
name
string
Novo nome. Ignorado se id == 1.
​
permissions
integer[]
Nova lista de identificadores de permissão. Omita para manter o conjunto atual.

​
Resposta

Retorna o grupo atualizado.
​
id
integer
​
name
string
​
permissions
integer[]
Lista completa e nova de identificadores de permissão.
{
  "id": 3,
  "name": "Account Admin",
  "permissions": [101, 102, 104]
}

​
Erros

StatusQuando
400name em conflito com outro grupo, ou identificador de permissão inválido / não permitido.
401Token ausente ou inválido.
403Quem chama não possui auth.manage_groups.
404Nenhum grupo corresponde ao identificador informado.

​
Exemplos

curl -X PATCH https://api.dlpay.cloud/user/groups/3/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"permissions": [101, 102, 104]}'