Equipe e papéis
O Dashboard da Fluxis permite que Owners e Admins da organização gerenciem colaboradores — membros da equipe que podem acessar o dashboard, configurar integrações e gerenciar credenciais de API.
Acesso ao dashboard
Gerencie sua equipe em:
/app/team
Apenas colaboradores com papéis Owner ou Admin podem acessar esta seção.
Papéis de colaborador
| Papel | Acesso ao dashboard |
|---|---|
| Owner | Acesso total; pode alterar papéis de outros Owners |
| Admin | Gerenciar membros da equipe, chaves de API, contas e a maioria das configurações |
| Operator | Tarefas operacionais (escopo definido pelas permissões do dashboard) |
| Guest | Acesso limitado orientado à leitura |
Os papéis são atribuídos como um array — um colaborador pode ter vários papéis, embora atribuições típicas usem um papel principal.
Ações de gestão de equipe
| Ação | Quem pode executar | Descrição |
|---|---|---|
| List members | Owner, Admin | Lista paginada (page, page_size) |
| Invite / create | Owner, Admin | Adicionar colaborador com nome, e-mail e papéis |
| Update profile | Owner, Admin | Alterar nome, telefone, país |
| Update roles | Owner, Admin | Alterar atribuição de papéis (PUT /team/roles/:id) |
| Remove member | Owner, Admin | Excluir colaborador (Owners não podem ser excluídos) |
Owners não podem ser excluídos. Tentativas de remover um colaborador com papel Owner são rejeitadas.
Atualizações de perfil (PUT /team/:id) aplicam-se apenas a colaboradores que atualmente têm papéis Admin ou Owner. Operators e Guests não podem ser atualizados por este endpoint.
Criar um membro da equipe
Informe:
| Campo | Obrigatório | Descrição |
|---|---|---|
first_name | Sim | Nome |
last_name | Sim | Sobrenome |
email | Sim | E-mail de login (deve ser único) |
roles | Sim | Array de strings de papel (owner, admin, operator, guest) |
phone | Não | Telefone de contato |
country | Não | Código do país |
Novos colaboradores recebem credenciais pelo fluxo de onboarding do dashboard (definir senha no primeiro login).
Hierarquia de papéis
Code
- Owner — maior privilégio; não pode ser excluído via API de equipe
- Admin — gestão do dia a dia, incluindo chaves de API em
/app/api-keys - Operator / Guest — escopo reduzido para necessidades operacionais específicas
Nomes de papel do dashboard (owner, admin, …) são distintos dos papéis de credencial de API (read, write) nas chaves de API. O papel do dashboard controla acesso à UI; papéis da chave controlam permissões da REST API.
Gestão de chaves de API por papel
| Papel no dashboard | Acesso a /app/api-keys |
|---|---|
| Owner | CRUD completo |
| Admin | CRUD completo |
| Operator | Sem acesso |
| Guest | Sem acesso |
Criar chaves de API exige verificação 2FA — consulte Autenticação de dois fatores.
Boas práticas
- Minimize Owners — mantenha poucos Owners; use Admin para a maior parte da equipe
- Use acesso adequado ao papel — Operators e Guests não devem gerenciar credenciais
- Remova membros que saíram com rapidez — exclua colaboradores quando deixarem a organização
- Separe chaves de API por serviço — crie chaves distintas por integração em vez de compartilhar uma chave entre equipes
Escopo organização vs conta
Colaboradores pertencem a uma organização. Chaves de API em nível de organização podem acessar todas as contas dessa organização (sujeito aos papéis de API). Recursos específicos de conta (webhooks, endereços de liquidação por conta) são gerenciados no contexto da conta no dashboard.
Documentação relacionada
- Credenciais de API — chaves REST API (apenas Owner/Admin)
- Autenticação de dois fatores — obrigatória para ações sensíveis
- Cadastro — como as organizações são provisionadas