La API v3 se encuentra actualmente en fase beta. Algunos endpoints pueden cambiar a medida que mejoramos la API.
https://api.devin.ai/v3beta1/enterprise/*– endpoints que requieren permisos Enterprise (a nivel de cuenta)https://api.devin.ai/v3beta1/organizations/*– endpoints con alcance a una sola organización
Algunos endpoints de Enterprise operan sobre organizaciones específicas, pero siguen estando protegidos por
permisos a nivel Enterprise. Estos usan rutas como
/v3beta1/enterprise/organizations/{org_id}/...
(por ejemplo, GET /v3beta1/enterprise/organizations/{org_id}/audit-logs).
Aunque incluyan un parámetro de ruta org_id, siguen requiriendo
permisos a nivel Enterprise como ManageEnterpriseSettings.Permisos y RBAC
Tipos de permisos
| Permiso | Descripción | Endpoints |
|---|---|---|
ManageAccountKnowledge | Administrar notas de Knowledge a nivel de Enterprise u organización | Endpoints de notas (GET, POST, PUT, DELETE) |
ManageAccountPlaybooks | Administrar playbooks a nivel de Enterprise u organización | Endpoints de playbooks (GET, POST, PUT, DELETE) |
ManageEnterpriseSettings | Administrar la configuración a nivel de Enterprise, incluidas las etiquetas de la organización | Endpoints de etiquetas, administración de organizaciones |
Ámbitos de los usuarios de servicio
/v3beta1/enterprise/*.
Los usuarios de servicio de organización están limitados a una organización específica y solo pueden acceder a los recursos dentro de esa organización. Usan endpoints bajo /v3beta1/organizations/{org_id}/*.
Creación de usuarios de servicio
- Enterprise Settings → Service Users: Crea usuarios de servicio a nivel enterprise o de organización con roles personalizados
Self
Registros de auditoría
Registros de auditoría de Enterprise
Obtén registros de auditoría a nivel Enterprise
Registros de auditoría de la organización
Obtén registros de auditoría de una organización específica
Consumo
Ciclos de consumo
Consulta resúmenes de ciclos de consumo
Consumo diario
Obtén desgloses diarios de consumo
Por organización
Realiza un seguimiento del consumo por organización
Por usuario
Realiza un seguimiento del consumo por usuario
Por sesión
Realiza un seguimiento del consumo por sesión
Organizaciones
Listar organizaciones
Ver todas las organizaciones
Crear organización
Crear una nueva organización
Actualizar organización
Actualizar la configuración de la organización
Eliminar organización
Eliminar una organización
Service Users
Listar usuarios de servicio de Enterprise
Ver usuarios de servicio de Enterprise
Crear usuario de servicio de Enterprise
Crear un usuario de servicio de Enterprise
Actualizar usuario de servicio de Enterprise
Actualizar un usuario de servicio de Enterprise
Eliminar usuario de servicio de Enterprise
Eliminar un usuario de servicio de Enterprise
Listar usuarios de servicio de la organización
Ver usuarios de servicio de la organización
Crear usuario de servicio de la organización
Crear un usuario de servicio de la organización
Usuarios
Listar usuarios del Enterprise
Ver usuarios del Enterprise
Agregar usuario al Enterprise
Agregar un usuario al Enterprise
Actualizar usuario del Enterprise
Actualizar un usuario del Enterprise
Eliminar usuario del Enterprise
Eliminar un usuario del Enterprise
Listar usuarios de la organización
Ver usuarios de la organización
Agregar usuario a la organización
Agregar un usuario a una organización
Grupos de IdP
Listar grupos de Enterprise
Ver grupos de IdP de la cuenta Enterprise
Agregar grupo de Enterprise
Agregar un grupo de IdP a la cuenta Enterprise
Listar grupos de la organización
Ver grupos de IdP de la organización
Agregar grupo de la organización
Agregar un grupo de IdP a una organización
Permisos de Git
Listar permisos
Consulta los permisos de Git de una organización
Agregar permiso
Agregar un permiso de Git
Eliminar permiso
Eliminar un permiso de Git
Notas
Listar notas de Enterprise
Ver notas de Knowledge a nivel Enterprise
Crear nota de Enterprise
Crear una nueva nota a nivel Enterprise
Listar notas de organización
Ver notas de Knowledge a nivel de organización
Crear nota de organización
Crear una nueva nota a nivel de organización
Playbooks
Listar playbooks de Enterprise
Ver playbooks de Enterprise
Crear playbook de Enterprise
Crear un nuevo playbook de Enterprise
Listar playbooks de organización
Ver playbooks de organización
Crear playbook de organización
Crear un nuevo playbook de organización
Sesiones
Obtener etiquetas
Ver las etiquetas de una organización
Agregar etiquetas
Añadir etiquetas a una organización
Reemplazar etiquetas
Reemplazar todas las etiquetas de una organización
Eliminar etiqueta
Eliminar una etiqueta específica
Roles y métricas
Listar roles
Ver roles disponibles
Métricas de uso
Obtener métricas de uso del plan Enterprise
Métricas de organización
Obtener métricas de uso de la organización
Ejemplos de uso
Ver ejemplos de código
Explora ejemplos de código y casos de uso comunes de la API v3