Grupos de empresas
Agrupamentos de empresas para escopo de acesso.
Listar grupos de empresas
Lista os grupos de empresas da organização. Requer a permissão `identity.companies.read`. Listagem paginada no envelope `{items, page}` com `limit`/`cursor` (também aceita `sort`, `q` e `filter`).
Criar grupo de empresas
Cria um grupo com `name` (até 80 caracteres) e `description` opcional. Requer a permissão `identity.companies.create` ou `identity.companies.update`. Nome já usado na organização retorna `409`.
Consultar grupo de empresas
Retorna nome, descrição e datas do grupo. Requer a permissão `identity.companies.read`. O `group_id` é o UUID do grupo; grupo inexistente retorna `404`.
Atualizar grupo de empresas
Altera `name` e/ou `description`. Requer a permissão `identity.companies.update`. O `group_id` é o UUID do grupo; grupo inexistente retorna `404`. Nome já usado na organização retorna `409`.
Excluir grupo de empresas
Exclui o grupo e desvincula as empresas que faziam parte dele (elas continuam cadastradas); responde `204`. Requer a permissão `identity.companies.delete`. O `group_id` é o UUID do grupo; grupo inexistente retorna `404`.
Listar empresas do grupo
Lista as empresas do grupo, com as etiquetas de cada uma. Requer a permissão `identity.companies.read`. O `group_id` é o UUID do grupo; grupo inexistente retorna `404`. Listagem paginada no envelope `{items, page}` com `limit`/`cursor` (também aceita `sort`, `q` e `filter`).