Equipo y roles
El Dashboard de Fluxis permite a los Owners y Admins de la organización gestionar colaboradores — miembros del equipo que pueden acceder al dashboard, configurar integraciones y gestionar credenciales API.
Acceso al dashboard
Gestiona tu equipo en:
/app/team
Solo los colaboradores con roles Owner o Admin pueden acceder a esta sección.
Roles de colaborador
| Rol | Acceso al dashboard |
|---|---|
| Owner | Acceso completo; puede modificar roles de otros Owners |
| Admin | Gestionar miembros del equipo, claves API, cuentas y la mayoría de configuraciones |
| Operator | Tareas operativas (alcance definido por permisos del dashboard) |
| Guest | Acceso limitado orientado a lectura |
Los roles se asignan como un array — un colaborador puede tener varios roles, aunque las asignaciones típicas usan un rol principal único.
Acciones de gestión de equipo
| Acción | Quién puede realizarla | Descripción |
|---|---|---|
| List members | Owner, Admin | Lista paginada (page, page_size) |
| Invite / create | Owner, Admin | Agregar colaborador con nombre, email y roles |
| Update profile | Owner, Admin | Cambiar nombre, teléfono, país |
| Update roles | Owner, Admin | Cambiar asignación de roles de un colaborador (PUT /team/roles/:id) |
| Remove member | Owner, Admin | Eliminar un colaborador (los Owners no pueden eliminarse) |
Los Owners no pueden eliminarse. Los intentos de eliminar un colaborador con rol Owner son rechazados.
Las actualizaciones de perfil (PUT /team/:id) aplican solo a colaboradores que actualmente tienen roles Admin u Owner. Los Operators y Guests no pueden actualizarse mediante este endpoint.
Crear un miembro del equipo
Proporciona:
| Campo | Requerido | Descripción |
|---|---|---|
first_name | Sí | Nombre |
last_name | Sí | Apellido |
email | Sí | Email de inicio de sesión (debe ser único) |
roles | Sí | Array de cadenas de rol (owner, admin, operator, guest) |
phone | No | Teléfono de contacto |
country | No | Código de país |
Los nuevos colaboradores reciben credenciales mediante el flujo de incorporación del dashboard (establecer contraseña en el primer inicio de sesión).
Jerarquía de roles
Code
- Owner — máximo privilegio; no puede eliminarse vía la API de equipo
- Admin — gestión diaria incluyendo claves API en
/app/api-keys - Operator / Guest — alcance reducido para necesidades operativas específicas
Los nombres de rol del dashboard (owner, admin, …) son distintos de los roles de credencial API (read, write) en las claves API. El rol del dashboard de un colaborador controla el acceso a la UI; los roles de clave API controlan permisos de la REST API.
Gestión de claves API por rol
| Rol del dashboard | Acceso a /app/api-keys |
|---|---|
| Owner | CRUD completo |
| Admin | CRUD completo |
| Operator | Sin acceso |
| Guest | Sin acceso |
Crear claves API requiere verificación 2FA — consulta Autenticación de dos factores.
Mejores prácticas
- Minimiza Owners — mantén el conteo de Owners pequeño; usa Admin para la mayoría del equipo
- Usa acceso acorde al rol — Operators y Guests no deben gestionar credenciales
- Elimina miembros que se van con prontitud — elimina colaboradores cuando dejen tu organización
- Separa claves API por servicio — crea claves distintas por integración en lugar de compartir una clave entre equipos
Alcance organización vs cuenta
Los colaboradores pertenecen a una organización. Las claves API a nivel de organización pueden acceder a todas las cuentas bajo esa organización (sujeto a permisos de rol API). Los recursos específicos de cuenta (webhooks, direcciones de liquidación por cuenta) se gestionan en contexto de cuenta dentro del dashboard.
Documentación relacionada
- Credenciales API — claves REST API (solo Owner/Admin)
- Autenticación de dos factores — requerida para acciones sensibles
- Registro — cómo se provisionan las organizaciones