Si formas parte de una cuenta Enterprise con varias organizaciones o roles personalizados, consulta en su lugar el inicio rápido para Enterprise.
Paso 1: Crear un usuario de servicio
- Ve a Settings > Devin API en tu organización y abre la pestaña Usuarios de servicio
- Haz clic en Provision usuario de servicio
- Elige un nombre descriptivo para mostrar (p. ej., “CI Pipeline”, “Monitoring Bot”)
- Selecciona un rol en el menú desplegable Organization role. El formulario no incluye casillas para permisos individuales: el usuario de servicio obtiene sus permisos del rol que elijas.
- Admin — acceso completo, incluida la configuración de la organización y la membresía
- Member — puede crear y gestionar sesiones de Devin y la mayoría de los recursos de la organización, pero no la configuración de la organización ni la membresía
- Elige un valor en Caducidad. El valor predeterminado es 30 days; las demás opciones son 7 días, 90 días y, si tu cuenta lo permite, Never. A partir de la fecha de caducidad, la clave de API del usuario de servicio deja de funcionar, así que aprovisiona uno de reemplazo antes de esa fecha. Una caducidad más corta reduce el tiempo durante el que se podría usar una clave filtrada.
Paso 2: Copia tu clave de API
- Después de aprovisionar el usuario de servicio, su clave de API se muestra en un diálogo
- Copia la clave de inmediato: comienza con
cog_y no se mostrará de nuevo - Almacénala de forma segura como una variable de entorno:
Paso 3: Realiza tu primera llamada a la API
Crea una sesión de Devin:¿Quieres que las sesiones se atribuyan a tu usuario? De forma predeterminada, las sesiones se atribuyen al usuario de servicio. Para crear sesiones en nombre de un usuario específico (para que aparezcan en la lista de sesiones de ese usuario), agrega
"create_as_user_id": "user_abc123" al cuerpo de la solicitud. Esto requiere el rol de Admin (que incluye el permiso ImpersonateOrgSessions). Consulta Session attribution para más detalles.Paso 4: Operaciones habituales
Listar tus sesiones
Enviar un mensaje a una sesión activa
Gestionar Knowledge
Permisos para usuarios de Teams
Las organizaciones de Teams tienen un modelo de permisos sencillo:Los playbooks se están trasladando a Skills. En una cuenta de Teams que ya se ha migrado, las escrituras en
/playbooks se aplican a la skill del playbook. Las cuentas creadas a partir del 24 de octubre de 2026 que no tengan playbooks reciben un 410 de los endpoints de /playbooks.Próximos pasos
- Explora los endpoints de la Organization API en la barra lateral
- Consulta flujos comunes para patrones de integración habituales
- Obtén información detallada sobre la autenticación
- Configura automatizaciones programadas para tareas recurrentes

