La API de Devin te permite integrar Devin en tus aplicaciones, automatizar flujos de trabajo y crear herramientas potentes. Ofrecemos tres versiones de la API, cada una diseñada para diferentes casos de uso y modelos de autenticación.
Devin ofrece tres versiones de la API con distintas capacidades y requisitos de autenticación:
External API v1 (con alcance a nivel de organización)
https://api.devin.ai/v1/*
Autenticación: API keys personales o de servicio
Funciones clave:
- Crear y gestionar sesiones de Devin
- Enviar mensajes a sesiones activas
- Gestionar secretos, Knowledge y playbooks
- Subir y descargar archivos adjuntos
- Actualizar etiquetas de sesiones
Ideal para:
- Automatización general de sesiones
- Integraciones orientadas al usuario
- Pipelines de CI/CD
- Desarrollo y pruebas
Ver documentación de la API v1 →
API de Enterprise v2 (solo administradores de Enterprise)
https://api.devin.ai/v2/enterprise/*
Autenticación: Solo claves API personales de administradores de Enterprise
Funciones clave:
- Análisis e insights de sesiones a nivel de Enterprise
- Gestión de organizaciones y miembros
- Seguimiento del consumo y datos de facturación
- Registros de auditoría e informes de cumplimiento
- Gestión de permisos de Git
- Indexación de repositorios
Ideal para:
- Administradores de Enterprise
- Análisis e informes
- Cumplimiento y auditoría
- Gestión de organizaciones
Ver documentación de la API v2 →
API de usuarios de servicio v3 (RBAC)
https://api.devin.ai/v3beta1/enterprise/*https://api.devin.ai/v3beta1/organizations/*
Autenticación: Credenciales de usuario de servicio (a nivel Enterprise u organización)
Características clave:
- Control de acceso basado en roles (RBAC) completo
- Usuarios de servicio con roles específicos
- Permisos granulares
- Flujos de trabajo de multiorganización
- Separación clara entre cuentas humanas y de servicio
Ideal para:
- Automatización en producción con permisos específicos
- Integraciones de multiorganización
- Flujos de trabajo sensibles al cumplimiento normativo
- Integraciones de servicio de larga duración
Ver documentación de la API v3 →
- Para la API v1: Generar una API key desde Settings > API Keys en cualquier suborganización.
- Para la API v2: Generar una API key personal desde Settings > API Keys en cualquier suborganización.
- Para la API v3: Crear un usuario de servicio desde Enterprise Settings > Service Users.
Mantén seguras tus API keys y nunca las compartas en áreas de acceso público, como repositorios de GitHub o código del lado del cliente.
Realiza tu primera solicitud
Authorization:
Authorization: Bearer your_api_key_here
curl -X POST "https://api.devin.ai/v1/sessions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Crea un script sencillo de Python que imprima Hello World"
}'
Todas las API usan códigos de estado HTTP estándar:
200 OK: Solicitud exitosa201 Created: Recurso creado correctamente400 Bad Request: Parámetros de la solicitud no válidos401 Unauthorized: Falta la API key o no es válida403 Forbidden: Permisos insuficientes404 Not Found: Recurso no encontrado429 Too Many Requests: Se superó el límite de solicitudes500 Internal Server Error: Error del servidor
Si tienes preguntas sobre la API o deseas informar de algún problema, escribe a [email protected].
