API keys

Las API keys sirven para llamar a la plataforma desde fuera del panel: un script, una integración o un proceso automático que necesite buscar o preguntar sin que haya una persona con sesión iniciada.

Cada clave pertenece a la organización en la que la creaste y solo da acceso a su contenido.

Crear una clave

Al crearla puedes ponerle un nombre. No es obligatorio, pero conviene: es lo único que verás después para saber qué la usa ("Integración con el CRM", "Script de informes"). Si mañana hay que revocar una, el nombre es lo que te dice cuál.

Si pierdes una clave, la solución es revocarla y crear otra.

Usarla

La clave se manda en la cabecera x-api-key de cada petición. Sustituye a la sesión: donde una persona usa el panel con su cuenta, un programa usa su clave.

Consulta la documentación de la API para el detalle de los endpoints disponibles.

El caso más habitual es conectar un asistente de IA (Claude Code, Cursor, VS Code) al servidor MCP de la plataforma: está explicado paso a paso en Conectar tu asistente de IA.

Revocar

Revocar una clave la invalida de inmediato: cualquier programa que la esté usando empezará a recibir errores de autenticación en la siguiente petición.

No hay periodo de gracia ni forma de reactivarla, así que antes de revocar una clave que esté en producción conviene tener lista la que la sustituye.

Recomendaciones

• Una clave por integración, no una compartida entre varias. Así puedes revocar una sin dejar a las demás sin servicio.
• Trátalas como contraseñas. No las escribas en el código ni las subas a un repositorio: van en variables de entorno o en el gestor de secretos que uses.
• Revoca las que dejes de usar. Una clave olvidada sigue funcionando indefinidamente.

Actualizado el 05 ago 2026