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:Documentation Index
Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
Use this file to discover all available pages before exploring further.
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 guía rápida de 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
| 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 |
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) |
ManageOrgSchedules | Sesiones programadas |
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) |
Herencia de permisos
/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
- Usuarios de servicio de Enterprise: Enterprise settings → Service Users
- Usuarios de servicio de organización: Organization settings → Service Users