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.

Crear claves y usar la API requiere un plan Hobby o superior con facturación activa. Los miembros del espacio de trabajo pueden seguir viendo y revocando claves existentes tras perder ese derecho de acceso. Mejora tu plan →

Crear una clave de API

Ve a tu espacio de trabajo
Haz clic en Claves de API en la barra lateral
Haz clic en Crear clave de API
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

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

Las claves eliminadas dejan de funcionar de inmediato.

Revocar claves cuando caduca el acceso

Si tu espacio de trabajo pierde el acceso a la API, inicia sesión y elimina las claves que ya no necesites desde su página Claves de API. No tienes que renovar la facturación para revocarlas. Debes seguir siendo miembro del espacio de trabajo. Si tienes MFA activado, completa la verificación MFA antes de administrar claves. Hasta entonces, la base de datos oculta las claves del espacio de trabajo y rechaza su eliminación. Esto no restablece el uso de la API ni el permiso para crear claves.

Antes, Agentkit comprobaba el derecho de acceso de pago a la API antes de eliminar una clave. Las políticas de la base de datos también exigían ese derecho para leer o eliminar claves. Por tanto, perder el acceso podía bloquear la limpieza de una credencial existente.

La corrección separa la creación de la limpieza. La pertenencia al espacio de trabajo determina el acceso para leer y eliminar claves existentes, y una política de base de datos independiente aplica MFA. Crear y actualizar claves sigue requiriendo el derecho de acceso a la API. La acción de eliminación comprueba tanto el ID de la clave como el del espacio de trabajo y solo indica éxito si la base de datos devuelve una fila eliminada.

Este ejemplo simplificado describe el cambio de la comprobación:

Before
  Require API entitlement before deleting an existing key.

After
  Delete only a key belonging to the requested workspace.
  Require a returned deleted row before reporting success.
  Keep membership checks and enforce MFA in the database.

Las pruebas de la aplicación simulan el cliente de base de datos. Comprueban los filtros y la gestión de resultados, no las políticas de la base de datos. Las pruebas SQL usan cuentas sintéticas y revierten los cambios. Entre sus resultados esperados están:

Comprobación	Capa de prueba	Resultado esperado
Un miembro autorizado revoca sin derecho de acceso a la API	Simulación de aplicación	Sin consulta de derechos; filtros de clave y espacio de trabajo; el éxito requiere una fila devuelta
Un miembro autorizado revoca sin derecho de acceso a la API	SQL	Una clave del propio espacio de trabajo eliminada
Un miembro crea una clave sin derecho de acceso	Simulación de aplicación y SQL	Rechazado
Un miembro intenta eliminar una clave de otro espacio de trabajo	SQL	Ninguna fila eliminada
No se cumple el MFA requerido	SQL	Ninguna fila eliminada
La clave solicitada no existe o no es visible para quien llama	Simulación de aplicación	La acción indica un fallo

Estas son expectativas de regresión, no resultados de una prueba en producción. Aplica el mismo patrón de prueba a credenciales temporales en flujos de agentes. Cambia el acceso antes de la limpieza y comprueba tanto la limpieza autorizada correcta como el rechazo de la no autorizada.

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:

Crea una clave de API dedicada para Zapier
Usa esta clave en la conexión de Zapier
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
Para solicitudes a la API, 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