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 a nivel Enterprisehttps://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
/v3beta1/enterprise/*, y los permisos de nivel de organización controlan los endpoints /v3beta1/organizations/{org_id}/*. Un usuario de servicio de Enterprise con un permiso de nivel Enterprise hereda automáticamente el permiso correspondiente a nivel de organización en todas las organizaciones.
Permisos de Enterprise
| Permiso | Controles |
|---|---|
ReadAccountMeta | Cuenta propia (concedido a todos los usuarios de servicio de forma predeterminada) |
ManageEnterpriseSettings | Registros de auditoría, etiquetas de organización |
ManageOrganizations | Operaciones CRUD de organizaciones, límites de grupos de organización |
ManageAccountMembership | Roles, usuarios Enterprise, grupos de IdP Enterprise, pertenencia de usuarios de servicio Enterprise, registro de grupos de IdP Enterprise |
ManageAccountServiceUsers | Aprovisionamiento de usuarios de servicio Enterprise |
ManageAccountKnowledge | Notas de Knowledge Enterprise |
ManageAccountPlaybooks | Playbooks Enterprise |
ManageGitIntegrations | Conexiones Git, permisos de Git |
ManageBilling | Ciclos de consumo, desgloses diarios de consumo |
ViewAccountMetrics | Métricas de uso (DAU/WAU/MAU, PRs, sesiones, búsquedas, usuarios activos), estado de la cola |
ViewEnterpriseInfraDetails | Hipervisores |
ViewAccountSessions | Lista y detalles de sesiones Enterprise (solo lectura) |
ManageAccountSessions | Enviar mensajes a sesiones Enterprise |
ViewAccountSearches | Búsquedas Enterprise |
Permisos de la organización
| Permission | Controls |
|---|---|
ManageOrgSecrets | Operaciones CRUD de secretos |
ManageOrgKnowledge | Notas de Knowledge (organización) |
ManageOrgPlaybooks | Playbooks (organización) |
ManageOrgServiceUsers | Aprovisionamiento de usuarios de servicio (organización) |
ViewOrgSessions | Lista y detalle de sesiones (organización, solo lectura) |
ManageOrgSessions | Enviar mensajes, finalizar y archivar sesiones |
UseDevinSessions | Crear sesiones |
ImpersonateOrgSessions | Crear sesiones en representación de otros usuarios (create_as_user_id) |
ViewOrgSearches | Búsquedas (organización) |
Ámbitos de los usuarios de servicio
/v3beta1/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 /v3beta1/organizations/{org_id}/*. Se les asignan roles a nivel de organización.
Creación de usuarios de servicio
- UI: Enterprise Settings → Service Users — crea usuarios de servicio a nivel Enterprise o a nivel de organización con roles personalizados y genera tokens de API.
- API:
POST /v3beta1/enterprise/service-usersoPOST /v3beta1/organizations/{org_id}/service-users— aprovisiona usuarios de servicio de forma programática con un rol y un TTL específicos. Los permisos del nuevo usuario deben ser un subconjunto de los permisos de quien realiza la llamada (se evita la escalada de privilegios).
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 empresa registrados
Muestra los grupos de IdP registrados para esta empresa
Registrar grupos de empresa
Registra grupos de IdP para esta empresa
Eliminar grupo de empresa registrado
Elimina un grupo de IdP registrado en esta empresa
Listar grupos de empresa
Consulta las asignaciones de grupos de IdP de la empresa
Asignar grupo de empresa
Asigna un rol de grupo de IdP a nivel de empresa
Listar grupos de organización
Consulta las asignaciones de grupos de IdP de la organización
Asignar grupo de organización
Asigna un rol de grupo de IdP a nivel de 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
Listar sesiones
Ver las sesiones de una organización
Crear sesión
Crear una nueva sesión
Terminar sesión
Terminar una sesión activa
Archivar sesión
Archivar una sesión para referencia futura
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
Consulta ejemplos de código y casos de uso habituales de la API v3