Endpoint: GET /user/groups/{id}/
Autenticação: JWT obrigatório
Retorna a visão detalhada de um grupo — nome e lista completa de permissões concedidas. Use para renderizar um editor de grupo.

Pré-requisitos

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

Resposta

id
integer
name
string
permissions
object[]
Array com { id, name, codename } para cada permissão anexada.
{
  "id": 3,
  "name": "Account Admin",
  "permissions": [
    { "id": 101, "name": "Manage Users", "codename": "manage_users" },
    { "id": 102, "name": "Manage Accesses", "codename": "manage_accesses" }
  ]
}

Erros

StatusQuando
401Token ausente ou inválido.
403Quem chama não possui auth.manage_groups.
404Nenhum grupo corresponde ao identificador informado.

Exemplos

curl https://api.dlpay.cloud/user/groups/3/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"