Saltar al contenido principal
Esta guía te muestra cómo configurar el acceso a la API para equipos 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, roles personalizados o SSO (Single Sign-On), consulta en su lugar el inicio rápido para Enterprise.

​
Paso 1: Crear un usuario de servicio

  1. Ve a Settings > Service users en tu organización
  2. Haz clic en Create service user
  3. Elige un nombre descriptivo (p. ej., “CI Pipeline”, “Monitoring Bot”)
  4. Selecciona un rol:
    • Admin — acceso completo para gestionar sesiones, Knowledge, playbooks, secretos y la configuración
    • Member — puede crear y gestionar sesiones de Devin y ver recursos
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: Generar una API key

  1. Después de crear el usuario de servicio, haz clic en Generate API key
  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:
export DEVIN_API_KEY="cog_your_key_here"

​
Paso 3: Realiza tu primera llamada a la API

Crea una sesión de Devin: 
curl -X POST "https://api.devin.ai/v3/organizations/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script that prints Hello World"}'
No necesitas especificar tu ID de organización en la URL. Como tu usuario de servicio está asociado a una sola organización, la API lo resuelve automáticamente. Opcionalmente, puedes incluirlo así: /v3/organizations/{org_id}/sessions. Encuentra tu ID de organización en Settings → Organization details.
¿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

​
Enumerar tus sesiones

curl "https://api.devin.ai/v3/organizations/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

​
Enviar un mensaje a una sesión activa

export SESSION_ID="your_session_id"

curl -X POST "https://api.devin.ai/v3/organizations/sessions/$SESSION_ID/messages" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Please also add unit tests"}'

​
Gestionar Knowledge

# Listar entradas de Knowledge
curl "https://api.devin.ai/v3/organizations/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Crear una entrada de Knowledge
curl -X POST "https://api.devin.ai/v3/organizations/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Coding standards", "trigger_description": "When writing code", "body": "Use TypeScript strict mode..."}'

​
Permisos para usuarios de Teams

Las organizaciones de Teams tienen un modelo de permisos sencillo:
RolPuede crear sesionesPuede administrar recursosPuede administrar la configuración
MemberSíSí (Knowledge, playbooks, secrets)No
AdminSíSíSí
Para un control de acceso basado en roles (RBAC) más granular, consulta la guía de inicio rápido de Enterprise.

​
Próximos pasos