GET /v3/self, están protegidos por un permiso específico. Un usuario de servicio obtiene sus permisos del rol que tiene asignado; un token de acceso personal tiene los permisos del usuario que lo creó. 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ónhttps://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 inicio rápido para Enterprise para más detalles sobre la configuración.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:- Usuarios de servicio de Enterprise: Enterprise settings → Devin API (pestaña Service users)
- Usuarios de servicio de organización: Organization settings → Devin API (pestaña Service users)