Skip to main content
Cada endpoint de la API está protegido por un permiso específico asignado al rol del usuario de servicio que realiza la llamada. El permiso requerido para cada endpoint está documentado en su página de referencia de API correspondiente. Esta página proporciona un resumen de todos los permisos según su ámbito. URLs base:
  • https://api.devin.ai/v3/organizations/* — endpoints con ámbito en una única organización
  • https://api.devin.ai/v3/enterprise/* — endpoints que requieren permisos de nivel Enterprise
Los clientes de Devin Enterprise con un despliegue dedicado deben sustituir api.devin.ai por su dominio de API personalizado (por ejemplo, api.your-company.devinenterprise.com). Consulta la guía rápida de Enterprise para más detalles sobre la configuración.
Encuentra el ID de tu organización en la página Configuración → Usuarios de servicio.
Algunos endpoints de Enterprise operan sobre organizaciones específicas usando rutas como /v3/enterprise/organizations/{org_id}/... (por ejemplo, registros de auditoría y etiquetas). Aunque incluyan un parámetro org_id, requieren permisos de nivel Enterprise.

​
Permisos de Enterprise

​
Permisos de la organización

​
Herencia de permisos

Los usuarios de servicio de Enterprise se autentican mediante los endpoints /v3/enterprise/* y pueden operar en todas las organizaciones. Se les asignan roles a nivel de Enterprise y heredan automáticamente los permisos correspondientes a nivel de organización en cada una de ellas (por ejemplo, ViewAccountSessions concede ViewOrgSessions en todas las organizaciones). Los usuarios de servicio de organización están restringidos a una sola organización y se autentican únicamente mediante los endpoints /v3/organizations/{org_id}/*. Se les asignan roles a nivel de organización.

​
Creación de usuarios de servicio

Los usuarios de servicio se crean a través de la interfaz de usuario de Devin:
  1. Usuarios de servicio de Enterprise: Enterprise settings → Service Users
  2. Usuarios de servicio de organización: Organization settings → Service Users
Para obtener instrucciones de configuración, consulta la guía de inicio rápido de Teams o la guía de inicio rápido de Enterprise.