Automatización e integraciones
Crea un token de API y conecta la CLI de Flow
Delega solo los permisos que necesita tu trabajo desde la terminal.
Usa un token con permisos limitados para ejecutar los comandos admitidos de Flow desde la terminal. El token pertenece a tu espacio y actúa dentro de tu acceso actual; no es una cuenta independiente ni una autorización permanente.
La tabla compacta de tokens muestra estado, permisos, creador, fecha de creación, vencimiento y último uso. Los iconos de cada fila permiten restringir o revocar el token y mantienen las confirmaciones existentes. En el teléfono se muestran los mismos valores en tarjetas con etiquetas.
La columna Permisos muestra una cantidad. Selecciónala para revisar todos los permisos y sus claves técnicas en un diálogo sin modificar el token.
Antes de empezar
Para gestionar tokens, inicia sesión como Propietario o Administrador activo con permiso de gestión de tokens. Un rol personalizado de Administrador también necesita ese permiso. Solo el Propietario puede cambiar la caducidad predeterminada. La CLI requiere Python 3.11 o posterior y se instala desde el repositorio de Flow.
Emite un token limitado
Abre Automatizaciones → Tokens de API y espera a que cargue la política. Selecciona Crear token de API.
Introduce Nombre del token, elige solo los permisos delegables necesarios y fija una caducidad dentro de la política mostrada. Para consultar trabajo, empieza por
workspace.readywork_item.read; añade permisos específicos solo cuando los necesites.Crea el token. En la pantalla que lo muestra una sola vez, pulsa Copiar token, guárdalo de forma privada y selecciona He guardado este token. Después no podrás recuperarlo desde la lista.
Conecta la CLI
Desde tu copia del repositorio de Flow, instala la herramienta y consulta su ayuda:
uv tool install ./packages/cli
flow --helpEjecuta
flow auth login --urlseguido de la dirección HTTPS del servidor Flow de tu espacio. Introduce el token en la petición oculta; no lo pongas como argumento del comando. Comprueba la cuenta y lista los tickets accesibles:
flow auth status
flow work list --type ticketUsa
flow work show FLOW-123, sustituyendo la clave por una real de tu espacio, para consultar un ticket. La CLI también admite comentarios, asignaciones, carga y descarga, transiciones y exportaciones de informes según los permisos del token. Consulta--helpen el comando correspondiente antes de modificar datos.
La CLI guarda las credenciales locales de forma privada en ~/.config/relisc-flow/. flow auth logout elimina ese inicio de sesión local; no revoca el token en el servidor. Puedes usar la URL de una búsqueda abierta con flow search --url: reutiliza los filtros admitidos, no el almacenamiento de vistas reservado al navegador.
Restringe, revoca o recupera el acceso
En la lista, revisa caducidad, estado, permisos y último uso. Restringir token permite quitar permisos o adelantar la caducidad. Para ampliarlos o prolongarla necesitas otro token. Revocar token tiene efecto inmediato e irreversible; las automatizaciones dependientes también pierden esa credencial.
Si falla la autenticación, comprueba servidor, espacio, caducidad, revocación, rol actual y permisos. Si perdiste el secreto, debes sustituir el token: no puede volver a mostrarse. También se aplican límites de frecuencia y uso. Reintentar con el mismo token no corrige una denegación de permisos.