Documentación

Claves de API

Genera y administra claves de API para acceso programático.

Las claves de API permiten el acceso programático a tus agentes. Úsalas para integrar Agentkit en tus aplicaciones o conectar servicios de terceros.

Nota: las claves de API requieren un plan Hobby o superior con facturación activa. Los espacios de trabajo en el plan Free, con pagos vencidos o sin pagar no tienen acceso a la API. Mejora tu plan →

Crear una clave de API

  1. Ve a tu espacio de trabajo
  2. Haz clic en Claves de API en la barra lateral
  3. Haz clic en Crear clave de API
  4. Confirma en el cuadro de diálogo

La nueva clave aparece en la lista y se puede revelar o copiar en cualquier momento.

Ver y copiar claves

Cada clave de la lista está oculta de forma predeterminada. Usa el ícono del ojo para revelarla y el ícono de copia para copiarla al portapapeles.

Usar las claves de API

Incluye la clave en las solicitudes de la API:

curl -X POST 'https://your-domain.com/api/v1/chat' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"chatbotId": "uuid", "messages": [{"role": "user", "content": "Hello"}]}'

Documentación completa de la API →

Administrar claves

Ver todas las claves

Todas las claves del espacio de trabajo aparecen en la página Claves de API.

Eliminar una clave

  1. Encuentra la clave en la lista
  2. Haz clic en el ícono de la papelera
  3. Confirma la eliminación

Las claves eliminadas dejan de funcionar de inmediato.

Prácticas recomendadas de seguridad

Nunca expongas las claves

  • No subas claves a repositorios de git
  • No incluyas claves en código del lado del cliente
  • Usa variables de entorno

Rota las claves periódicamente

  • Crea claves nuevas periódicamente
  • Actualiza tus aplicaciones
  • Elimina las claves antiguas

Usar claves separadas

Crea claves distintas para:

  • Producción frente a desarrollo
  • Aplicaciones distintas
  • Miembros del equipo o servicios distintos

Alcance de las claves

Las claves de API están limitadas al espacio de trabajo donde se crean y tienen acceso a:

  • Todos los agentes del espacio de trabajo
  • Endpoints de la API de chat
  • Gestión de webhooks

Las claves no pueden:

  • Administrar miembros del equipo
  • Acceder a la facturación
  • Crear otras claves de API

Conexión con Zapier

Al conectarte con Zapier:

  1. Crea una clave de API dedicada para Zapier
  2. Usa esta clave en la conexión de Zapier
  3. Mantén esta clave separada de otros usos

Configurar Zapier →

Solución de problemas

Error "Invalid API key"

  • Verifica que la clave esté copiada correctamente
  • Revisa que no haya espacios al principio o al final
  • Confirma que la clave no se haya eliminado

Error "Clave no autorizada"

  • Asegúrate de que el agente pertenezca a tu espacio de trabajo
  • Verifica que el espacio de trabajo de la clave coincida
  • Confirma que tu espacio de trabajo esté en el plan Hobby o superior con facturación activa

La clave no funciona después de crearla

  • Intenta actualizar la página
  • Espera 30 segundos para que se propague
  • Crea una nueva clave si el problema persiste

Próximos pasos