Inicio rápido: Enterprise

Esta guía explica cómo configurar el acceso a la API para organizaciones Enterprise con roles personalizados, RBAC y compatibilidad multi-organización.

Si estás en un plan de Teams con una sola organización y no necesitas roles personalizados, la guía de inicio rápido de Teams es más sencilla.

Si eres cliente de Devin Enterprise con una implementación dedicada, deberás reemplazar api.devin.ai en todas las URL de la API por el dominio de API personalizado de tu organización (por ejemplo, api.your-company.devinenterprise.com). Ponte en contacto con el administrador de Devin de tu organización o con el equipo de soporte de Cognition si no tienes claro cuál es tu dominio de API.

Comprender los ámbitos de los usuarios de servicio

Los clientes Enterprise pueden crear usuarios de servicio en dos niveles:

Ámbito	URL base	Caso de uso
Enterprise	`/v3/enterprise/*`	Administración entre organizaciones, analítica, registros de auditoría, gestión de miembros
Organización	`/v3/organizations/{org_id}/*`	Sesiones, Knowledge, playbooks, secretos dentro de una sola organización

Un usuario de servicio Enterprise con permisos a nivel Enterprise hereda automáticamente los permisos correspondientes a nivel de organización en todas las organizaciones.

Paso 1: Crear un usuario de servicio

Usuario de servicio de Enterprise (acceso entre organizaciones)

Ve a Settings de Enterprise > API de Devin y abre la pestaña Usuarios de servicio
Haz clic en Aprovisionar > Usuario de servicio de Enterprise
Elige un nombre visible (p. ej., “Panel de analítica”, “Bot de aprovisionamiento de organizaciones”)
Asigna un rol de Enterprise con los permisos que tu integración necesite y elige una fecha de expiración

Usuario de servicio de organización (acceso a una sola organización)

Ve a Settings > API de Devin dentro de la organización de destino y abre la pestaña usuarios de servicio
Haz clic en Aprovisionar usuario de servicio
Elige un nombre visible, asigna un rol a nivel de organización y elige una fecha de expiración

También puedes aprovisionar un usuario de servicio de organización desde Settings de Enterprise > API de Devin haciendo clic en Aprovisionar > Usuario de servicio de organización y seleccionando la organización de destino.

Sigue el principio de privilegios mínimos: crea usuarios de servicio con ámbito de organización cuando tu integración solo necesite acceso a una organización. Usa usuarios de servicio de Enterprise únicamente para flujos de trabajo entre organizaciones.

Paso 2: Copiar 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 volverá a mostrarse
Almacénala de forma segura como una variable de entorno:

export DEVIN_API_KEY="cog_your_key_here"

Paso 3: Realizar tu primera llamada a la API

Ejemplo de endpoint de Enterprise

Enumera todas las organizaciones de tu cuenta Enterprise:

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

Ejemplo de endpoint de organización

Cree una sesión de Devin en una organización específica:

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": "Implement the feature described in JIRA-123"}'

Permisos y RBAC

Cada endpoint de la API, excepto GET /v3/self, requiere un permiso específico. El permiso requerido se documenta en la página de referencia de la API de cada endpoint. Los permisos se dividen en dos ámbitos:

Permisos de Enterprise — controlan los endpoints /v3/enterprise/* (por ejemplo, ManageOrganizations, ManageBilling, ViewAccountMetrics)
Permisos de organización — controlan los endpoints /v3/organizations/{org_id}/* (por ejemplo, UseDevinSessions, ManageOrgSecrets, ManageOrgPlaybooks)

Un usuario de servicio de Enterprise con un permiso de nivel Enterprise hereda automáticamente el permiso correspondiente a nivel de organización en todas las organizaciones. Por ejemplo, ViewAccountSessions otorga ViewOrgSessions en cada organización. Para ver la referencia completa de permisos, consulta la documentación de permisos y RBAC.

Flujos de trabajo empresariales habituales

Supervisar el consumo en todas las organizaciones

# Obtener desglose de consumo diario (usa marcas de tiempo Unix — ejemplo: del 1 al 31 de enero de 2025)
curl "https://api.devin.ai/v3/enterprise/consumption/daily?time_after=1735689600&time_before=1738368000" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

Consulta del registro de auditoría

curl "https://api.devin.ai/v3/enterprise/audit-logs" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

Administrar usuarios entre organizaciones

# Listar usuarios de Enterprise
curl "https://api.devin.ai/v3/enterprise/members/users" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Listar usuarios en una organización específica
curl "https://api.devin.ai/v3/enterprise/organizations/$DEVIN_ORG_ID/members/users" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

Próximos pasos

Consulta la referencia completa de permisos de la API
Obtén información detallada sobre la autenticación
Configura la paginación para conjuntos de resultados grandes
Revisa la guía de migración si migras desde v1/v2

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: Enterprise

Comprender los ámbitos de los usuarios de servicio

Paso 1: Crear un usuario de servicio

Usuario de servicio de Enterprise (acceso entre organizaciones)

Usuario de servicio de organización (acceso a una sola organización)

Paso 2: Copiar tu clave de API

Paso 3: Realizar tu primera llamada a la API

Ejemplo de endpoint de Enterprise

Ejemplo de endpoint de organización

Permisos y RBAC

Flujos de trabajo empresariales habituales

Supervisar el consumo en todas las organizaciones

Consulta del registro de auditoría

Administrar usuarios entre organizaciones

Próximos pasos

​Comprender los ámbitos de los usuarios de servicio

​Paso 1: Crear un usuario de servicio

​Usuario de servicio de Enterprise (acceso entre organizaciones)

​Usuario de servicio de organización (acceso a una sola organización)

​Paso 2: Copiar tu clave de API

​Paso 3: Realizar tu primera llamada a la API

​Ejemplo de endpoint de Enterprise

​Ejemplo de endpoint de organización

​Permisos y RBAC

​Flujos de trabajo empresariales habituales

​Supervisar el consumo en todas las organizaciones

​Consulta del registro de auditoría

​Administrar usuarios entre organizaciones

​Próximos pasos

Comprender los ámbitos de los usuarios de servicio

Paso 1: Crear un usuario de servicio

Usuario de servicio de Enterprise (acceso entre organizaciones)

Usuario de servicio de organización (acceso a una sola organización)

Paso 2: Copiar tu clave de API

Paso 3: Realizar tu primera llamada a la API

Ejemplo de endpoint de Enterprise

Ejemplo de endpoint de organización

Permisos y RBAC

Flujos de trabajo empresariales habituales

Supervisar el consumo en todas las organizaciones

Consulta del registro de auditoría

Administrar usuarios entre organizaciones

Próximos pasos