Endpoint: GET /user/groups/permissions/
Autenticação: JWT obrigatório
Retorna o catálogo completo de permissões que podem ser anexadas a um grupo. Permissões dos módulos internos da plataforma (auth, admin, contenttypes, sessions) são filtradas. Use os identificadores retornados no campo permissions de POST /user/groups/ e de PUT/PATCH /user/groups/{id}/. As permissões são ordenadas por módulo de origem e, em seguida, pelo codename, permitindo agrupá-las por módulo na sua interface sem precisar reordenar.

Pré-requisitos

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

Resposta

Retorna um array de objetos de permissão.
id
integer
Identificador da permissão.
name
string
Rótulo legível, por exemplo "Manage Users".
codename
string
Codinome usado pelo sistema, por exemplo "manage_users". Combinado com o módulo de origem, é o valor verificado nas checagens de permissão.
[
  { "id": 101, "name": "Manage Users", "codename": "manage_users" },
  { "id": 102, "name": "Manage Accesses", "codename": "manage_accesses" },
  { "id": 103, "name": "Manage Groups", "codename": "manage_groups" }
]

Erros

StatusQuando
401Token ausente ou inválido.
403Quem chama não possui auth.manage_groups.

Exemplos

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