Saltar al contenido principal
Esta guía te muestra cómo configurar el acceso a la API para Teams y organizaciones estándar (no Enterprise). Crearás un usuario de servicio, obtendrás tus credenciales y harás tu primera llamada a la API en minutos.
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

  1. Ve a Settings > Devin API en tu organización y abre la pestaña Usuarios de servicio
  2. Haz clic en Provision usuario de servicio
  3. Elige un nombre descriptivo para mostrar (p. ej., “CI Pipeline”, “Monitoring Bot”)
  4. 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
  5. 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.
Usa el rol de Member para la mayoría de las automatizaciones. Usa Admin solo si tu integración necesita gestionar la configuración de la organización u otros usuarios.

Paso 2: Copia tu clave de API

  1. Después de aprovisionar el usuario de servicio, su clave de API se muestra en un diálogo
  2. Copia la clave de inmediato: comienza con cog_ y no se mostrará de nuevo
  3. 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:
Encuentra tu ID de organización en la parte superior de la página Settings → Devin API.
¿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.
Para un control de acceso basado en roles (RBAC) más granular, consulta el inicio rápido para Enterprise.

Próximos pasos