Criar usuário
POST/v1/usuarios
Cria um usuário na empresa do contexto, já com as permissões correspondentes ao tipo, e dispara o e-mail para o PRÓPRIO usuário definir a senha — a API nunca recebe nem define senha. Use no onboarding de uma pessoa nova (fluxo administrativo; ver a receita "Cadastrar usuário e liberar acesso a unidades"). Perfil exigido: Administrador da empresa. permissaoInicial (ID de GET /v1/permissoes) é obrigatória para os tipos 3 (Operacional) e 4 (Chamado) e ignorada para o tipo 2 (Administrador). Login único entre usuários ativos e e-mail único por empresa (422 se já existirem). Responde 201 com o usuario criado e as permissões geradas; 201 NÃO garante que o e-mail foi enviado — confira linkDefinicaoSenhaEnviado e, se false, use POST /v1/usuarios/{id}/reenviar-definicao-senha. Não repita este POST por falha de e-mail: o login já existe. Efeito externo (cria acesso ao sistema e envia e-mail). Exija confirmação humana antes de executar a partir de um agente autônomo.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 422
- 500
Usuário criado.
Payload inválido (campo obrigatório ausente, tamanho excedido, tipo fora do enum ou campo removido do contrato).
Não autenticado — token ausente, inválido ou expirado.
Quem chama não é administrador da empresa.
Empresa, cargo ou setor não encontrado.
Regra de negócio violada (login/e-mail duplicado, perfil incompatível ou ausente).
Erro interno.