Grupos
Grupos de membros.
Listar grupos
Lista os grupos da organização. Listagem paginada no envelope `{items, page}`, com `limit`, `cursor`, `sort`, `q` e `filter`. Requer a permissão `identity.groups.read`.
Criar grupo
Cria um grupo com nome de 1 a 80 caracteres e descrição opcional de até 2000. Nome já usado retorna `409`. Responde `201`. Requer a permissão `identity.groups.manage`.
Consultar grupo
Devolve um grupo da organização. `group_id` é o código público de 4 caracteres. Requer a permissão `identity.groups.read`.
Atualizar grupo
Altera nome e/ou descrição de um grupo (`group_id` é o código público); só os campos enviados mudam. Nome já usado retorna `409`. Requer a permissão `identity.groups.manage`.
Excluir grupo
Exclui um grupo da organização (`group_id` é o código público). Grupo inexistente retorna `404`. Requer a permissão `identity.groups.manage`.
Listar membros do grupo
Lista os membros de um grupo (`group_id` é o código público). Listagem paginada no envelope `{items, page}`, com `limit`, `cursor`, `sort`, `q` e `filter`. Requer a permissão `identity.groups.read`.
Adicionar membro ao grupo
Inclui no grupo o membro informado em `membership_id` (UUID). Membro já presente retorna `409`; grupo ou membro inexistente retorna `404`. Requer a permissão `identity.groups.manage`.
Remover membro do grupo
Retira o membro `membership_id` (UUID) do grupo `group_id` (código público). Vínculo inexistente retorna `404`. Requer a permissão `identity.groups.manage`.