Skip to content

Criar usuário

POST
/tenant/users

Cria um novo usuário ou vincula um usuário existente ao tenant.

Comportamento

  1. Se o login não existe na plataforma → cria novo usuário e vincula ao tenant
  2. Se o login existe mas não está vinculado ao tenant → vincula o usuário existente
  3. Se o login já está vinculado ao tenant → retorna erro

Importante: Usuários são compartilhados entre tenants. Se o login já existe em outro tenant, o mesmo usuário será vinculado (não duplicado).

Campos Opcionais

Após criar o usuário, você pode definir permissões iniciais:

Campo Descrição
groups IDs dos grupos a associar
bi_desks IDs das mesas de BI a liberar
apps_deny IDs das aplicações a bloquear
table_restrictions Filtros de dados por tabela

Mensagens de Erro

Mensagem Causa
Login já está cadastrado Usuário já vinculado ao tenant
App {id} não encontrado ID em apps_deny não existe
Mesa de aplicação {id} não encontrada ID em bi_desks não existe
Tabela {id} não encontrada ID em table_restrictions não existe
Grupo {id} não encontrado ID em groups não existe

Autorizações

tenantBearerAuth

Token de acesso do tenant

TipoHTTP (bearer)

Corpo da Requisição

application/json
JSON
{
"login": "novo.usuario@empresa.com"
}

Respostas

Operação processada

application/json
JSON
{
"success": true
}

Playground

Autorização
Corpo

Exemplos

Desenvolvido por VitePress OpenAPI