Esta guía recorre las personas y la organización de la empresa por API. El agente que integra con IA tiene la versión resumida en la ficha Usuarios y organización. Desde la terminal, cada operación tiene su subcomando, por ejemplo redcumbre usuarios invitar; la lista completa está en CLI de REDCUMBRE.
Asignar roles de plataforma o de máquina.SUPER-ADMIN, MASTER y los roles de las llaves responden 403, también dentro de un grupo de roles o al invitar. GET /{tenantSlug}/roles/assignable lista lo que sí puedes dar.
Tocar cuentas intocables. Una persona con SUPER-ADMIN en cualquier empresa, con un rol global o con un grupo de roles activo que lo contiene no se edita, no se quita, no se le cambian los roles ni la clave, y sus sesiones no se listan ni se cierran: responde 403.
Editar a una persona de dos empresas. Editar su perfil, listar sus sesiones y cerrarlas responde 403 sin nombrar a la otra empresa. Cambiarle roles, quitarla de tu empresa, restablecerle la clave y asignarle sucursales siguen abiertos.
Ver personas de otra empresa. Un id ajeno responde 404, igual que uno inventado.
Dar de alta con clave. Sólo se invita por correo (passwordModeauto_invite); temp_password, tempPassword y manual_invite responden 400. Consultar un correo responde sólo si ya es de tu empresa.
Fijar o leer claves. El restablecimiento sólo envía el correo: una petición con password responde 400 y ninguna respuesta trae una clave.
Registrar, conectar o anular puestos. Registrar un puesto, usar «este navegador», la reconexión, anular y levantar el bloqueo son del panel y del aparato del puesto.
Cambiar el RUT de una persona. Es sólo del panel.
Cada vez que una llave de producción da ADMIN, los SUPER-ADMIN de la empresa reciben un aviso que nombra a la persona y a la llave.
Una persona sale con id, zitadelUserId, email, nombre, apellido, nombreCompleto, rut, telefono, sus roles y gruposDeRoles de esta empresa, createdAt y updatedAt; nunca claves, segundo factor, IP ni roles de otra empresa. GET /{tenantSlug}/users se pagina con page y limit (hasta 300). Las rutas de sucursales usan el zitadelUserId de la persona. El 409 de una invitación significa que la persona ya es de tu empresa.
Con una llave de prueba, todo responde desde un conjunto de ejemplo y no se guarda nada: no se invita a nadie, no se cambian roles y no se manda ningún correo. Las escrituras validan el cuerpo como en producción y responden como hechas, con identificadores negativos. El techo de roles y las cuentas intocables rigen igual. Nada se cobra. Cuando todo funcione, repite con la llave de producción.