Inicio rápido: Equipos

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

Ve a Settings > Devin API en tu organización y abre la pestaña Service users
Haz clic en Provision service user
Elige un nombre descriptivo para mostrar (p. ej., “CI Pipeline”, “Monitoring Bot”)
Selecciona un rol:
- 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

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

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:

export DEVIN_API_KEY="cog_your_key_here"

Paso 3: Realiza tu primera llamada a la API

Crea una sesión de Devin:

export DEVIN_ORG_ID="your_org_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script that prints Hello World"}'

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

curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/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/$DEVIN_ORG_ID/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/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

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

Permisos para usuarios de Teams

Las organizaciones de Teams tienen un modelo de permisos sencillo:

Rol	Puede crear sesiones	Puede administrar recursos	Puede administrar la configuración
Member	Sí	Sí (Knowledge, playbooks, secrets)	No
Admin	Sí	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

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

Primeros pasos

Conceptos

Ciclo de vida del agente

Gestión del contexto

Gestión de Environment

Automatización

Integraciones

Analítica

Observabilidad

Devin para seguridad

Infraestructura

Identidad y acceso

Configuración

API heredada v1

API heredada v2

Inicio rápido: Equipos

Paso 1: Crear un usuario de servicio

Paso 2: Copia tu clave de API

Paso 3: Realiza tu primera llamada a la API

Paso 4: Operaciones habituales

Listar tus sesiones

Enviar un mensaje a una sesión activa

Gestionar Knowledge

Permisos para usuarios de Teams

Próximos pasos

​Paso 1: Crear un usuario de servicio

​Paso 2: Copia tu clave de API

​Paso 3: Realiza tu primera llamada a la API

​Paso 4: Operaciones habituales

​Listar tus sesiones

​Enviar un mensaje a una sesión activa

​Gestionar Knowledge

​Permisos para usuarios de Teams

​Próximos pasos

Paso 1: Crear un usuario de servicio

Paso 2: Copia tu clave de API

Paso 3: Realiza tu primera llamada a la API

Paso 4: Operaciones habituales

Listar tus sesiones

Enviar un mensaje a una sesión activa

Gestionar Knowledge

Permisos para usuarios de Teams

Próximos pasos