Papéis
Papéis e permissões (RBAC).
Listar papéis
Lista os papéis da organização, incluindo os papéis virtuais. Listagem paginada no envelope `{items, page}`, com `limit`, `cursor`, `sort`, `q` e `filter`. Requer a permissão `identity.roles.read`.
Criar papel
Cria um papel personalizado, sem permissões, com nome de 1 a 80 caracteres. Nome já usado retorna `409`. Responde `201`. Requer a permissão `identity.roles.manage`.
Consultar papel
Devolve um papel e suas permissões. `role_id` é o código público de 4 caracteres. Requer a permissão `identity.roles.read`.
Renomear papel
Altera o nome de um papel personalizado (1 a 80 caracteres; `role_id` é o código público). Papéis virtuais não podem ser alterados (`400` `virtual_role`) e nome já usado retorna `409`. Requer a permissão `identity.roles.manage`.
Excluir papel
Exclui um papel personalizado (`role_id` é o código público). Papéis virtuais não podem ser excluídos (`400` `virtual_role`). Requer a permissão `identity.roles.manage`.
Definir permissões do papel
Substitui todas as permissões de um papel personalizado pela lista enviada em `permission_keys` (`role_id` é o código público). Papéis virtuais retornam `400` `virtual_role` e permissões não permitidas retornam `400`. Requer a permissão `identity.roles.manage`.