Skip to main content
La API de Devin te permite integrar Devin en tus aplicaciones, automatizar flujos de trabajo y crear herramientas potentes. Usa usuarios de servicio con control de acceso basado en roles para disponer de un acceso a la API seguro y auditable.

​
Primeros pasos

Inicio rápido de Teams

Para equipos y organizaciones estándar. Crea un usuario de servicio y realiza tu primera llamada a la API en minutos.

Inicio rápido de Enterprise

Para clientes Enterprise con RBAC, compatibilidad con múltiples organizaciones y permisos avanzados.
¿Qué opción debería elegir? La mayoría de los clientes deberían empezar con el inicio rápido de Teams. Elige Enterprise si administras varias organizaciones, usas inicio de sesión único (SSO) o necesitas roles personalizados y RBAC.

​
Estructura de la API

La API está organizada en dos ámbitos principales:

​
API de organización

URL base: https://api.devin.ai/v3/organizations/* Para gestionar recursos dentro de una única organización — sesiones, Knowledge, playbooks, secretos y más. Aquí es donde se inician la mayoría de las integraciones.

​
API Enterprise

URL base: https://api.devin.ai/v3/enterprise/* Para la administración entre organizaciones: analítica, registros de auditoría, gestión de usuarios, facturación e infraestructura. Disponible para clientes Enterprise. Ambos scopes usan credenciales de usuario de servicio (prefijo cog_). Consulta Authentication para la configuración.

​
Atribución de sesión

Los usuarios de servicio son identidades separadas de los usuarios humanos, pero puedes crear sesiones en nombre de cualquier usuario de tu organización con el parámetro create_as_user_id. Esto significa que las sesiones aparecen en la lista de sesiones de ese usuario y se contabilizan en su uso, como si las hubiera creado el propio usuario.
¿Vienes de usar API keys personales? En v1/v2, las API keys personales creaban sesiones automáticamente como tu usuario. Con v3, usa un usuario de servicio + create_as_user_id para obtener el mismo comportamiento, con el beneficio adicional de RBAC, registros de auditoría y gestión centralizada de claves. El rol del usuario de servicio debe incluir el permiso ImpersonateOrgSessions.
También puedes autenticarte directamente como tu usuario con un Personal Access Token, sin necesidad de un usuario de servicio ni de create_as_user_id. Las sesiones se te atribuyen automáticamente.
Puedes encontrar los IDs de usuario mediante el endpoint List organization users (beta, requiere un usuario de servicio con ámbito de organización) o el endpoint List users de Enterprise. Ambos devuelven solo los usuarios con asignaciones de rol directas. Para los usuarios cuya membresía proviene de grupos de IdP, usa List organization IDP group users o su equivalente de Enterprise.

​
API heredadas (v1 y v2)

Las API v1 y v2 continúan funcionando durante el período de deprecación, pero ya no recibirán nuevas funcionalidades. Recomendamos migrar a la API actual para disponer de control de acceso basado en roles, atribución de sesiones y nuevas capacidades.

​
Manejo de errores

Todas las API usan códigos de estado HTTP estándar:
  • 200 OK: Solicitud exitosa
  • 201 Created: Recurso creado correctamente
  • 400 Bad Request: Parámetros de la solicitud no válidos
  • 401 Unauthorized: Falta la API key o no es válida
  • 403 Forbidden: Permisos insuficientes
  • 404 Not Found: Recurso no encontrado
  • 429 Too Many Requests: Se superó el límite de solicitudes
  • 500 Internal Server Error: Error del servidor

​
Soporte

Si tienes preguntas sobre la API o deseas informar de algún problema, escribe a support@cognition.ai.