Skip to content

Configurar permissão de grupo

POST
/tenant/datamart/{id}/group

Cria ou atualiza a permissão de um grupo para acessar uma tabela do datamart.

Comportamento Idêntico ao de Usuário

Este endpoint funciona exatamente como o POST /tenant/datamart/{id}/user,
mas usa groupId em vez de userId.

Vantagens de Usar Grupos

  1. Escalabilidade: Configure uma vez, aplique a muitos usuários
  2. Manutenção: Atualize em um lugar, afete todos os membros
  3. Onboarding: Novos funcionários herdam permissões automaticamente

Campos Aceitos

Campo Tipo Descrição
groupId integer ID do grupo (obrigatório)
tableId integer ID da tabela (obrigatório)
allowed boolean Acesso permitido (obrigatório)
allow_export boolean Pode exportar (obrigatório)
expires_in datetime Expiração (opcional)
hidden_columns string[] Colunas ocultas (opcional)
filters object[] Filtros RLS (opcional)

Mensagens de Erro

Mensagem Causa
Datamart not found ID do datamart não existe
Table not found tableId não existe no tenant
Invalid groupId Grupo não existe ou foi excluído

Autorizações

tenantBearerAuth

Token de acesso do tenant

TipoHTTP (bearer)

Parâmetros

Parâmetros de Caminho

id*

ID do datamart

Tipointeger
Obrigatório
Example1

Corpo da Requisição

application/json
JSON
{
"groupId": 5,
"tableId": 100,
"allowed": true,
"allow_export": false,
"hidden_columns": [
"margem",
"custo"
],
"filters": [
{
"column": "regiao",
"operator": "=",
"value": "Sul"
}
]
}

Respostas

Permissão de grupo salva com sucesso

application/json
JSON
{
"status": "success",
"data": true
}

Playground

Autorização
Variáveis
Chave
Valor
Corpo

Exemplos

Desenvolvido por VitePress OpenAPI