Saltar al contenido principal

Linear

¿Prefieres configuracion guiada con IA?

En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.

Descripción General​

Conecta tu workspace de Linear a Nirvai para gestionar issues, proyectos y cycles programáticamente usando la API GraphQL de Linear.

Métodos de Autenticación Soportados​

  • Personal API Key - Recomendado para integraciones personales

Requisitos Previos​

  • Una cuenta de Linear (gratis o de pago)
  • Acceso al workspace que quieres conectar

Instrucciones de Configuración​

Generar una Personal API Key​

  1. Inicia sesión en tu workspace de Linear
  2. Haz clic en tu avatar (abajo a la izquierda)
  3. Ve a Settings
  4. Navega a Security & access > API
  5. Bajo "Personal API keys", haz clic en Create key
  6. Ingresa una etiqueta para tu clave (ej., "Integración Nirvai")
  7. Haz clic en Create
  8. Importante: Copia la API key inmediatamente - no se mostrará de nuevo
  9. En Nirvai, crea una nueva credencial de Linear y pega la clave

Ruta Alternativa​

Accede directamente a la configuración de API en:

https://linear.app/settings/api

Permisos de API Key​

Las Personal API keys:

  • Tienen acceso completo a tu cuenta de Linear
  • Pueden leer y escribir issues, proyectos, cycles, etc.
  • Están limitadas a los workspaces a los que tienes acceso
  • No expiran pero pueden ser revocadas

API GraphQL​

Linear usa una API GraphQL. Características clave:

  • Endpoint único: https://api.linear.app/graphql
  • Consultas flexibles - solicita solo los datos que necesitas
  • Suscripciones en tiempo real disponibles
  • Filtrado y paginación ricos

Solución de Problemas​

Problemas Comunes​

  • 401 Unauthorized: La API key es inválida o fue revocada. Genera una nueva clave.
  • 403 Forbidden: No tienes permiso para el recurso solicitado.
  • Rate limits: Linear aplica límites de tasa. Implementa estrategias de backoff.
  • Complejidad de query: Las queries GraphQL tienen límites de complejidad. Simplifica si es necesario.

Gestionar API Keys​

Para ver o revocar claves existentes:

  1. Ve a Settings > Security & access > API
  2. Ve todas las claves activas bajo "Personal API keys"
  3. Haz clic en el icono de eliminar para revocar una clave

Límites de Tasa​

Linear aplica estos límites:

  • 1500 solicitudes por hora (básico)
  • 6000 solicitudes por hora (de pago)
  • Se aplican límites de complejidad de query
  • Los headers indican la cuota restante

Mejores Prácticas​

Seguridad de API Key​

  • Nunca compartas o expongas tu API key
  • No commits claves a control de versiones
  • Usa variables de entorno
  • Revoca claves no utilizadas

Queries Eficientes​

  • Solicita solo los campos que necesitas
  • Usa paginación para listas grandes
  • Aprovecha el filtrado a nivel de API
  • Considera webhooks para actualizaciones en tiempo real

Recursos Relacionados​

Adaptado para la plataforma Nirvai

Siguientes Pasos​

¿Ya tienes tu credencial? Conectala a un agente

Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.