> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido: Enterprise

> Empieza a usar la Devin API como usuario Enterprise con RBAC y compatibilidad multi-organización

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

<Note>
  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/api-reference/getting-started/teams-quickstart) es más sencilla.
</Note>

<Note>
  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.
</Note>

<div id="understanding-service-user-scopes">
  ## Comprender los ámbitos de los usuarios de servicio
</div>

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.

<div id="step-1-create-a-service-user">
  ## Paso 1: Crear un usuario de servicio
</div>

<div id="enterprise-service-user-cross-org-access">
  ### Usuario de servicio de Enterprise (acceso entre organizaciones)
</div>

1. Ve a **Configuración de Enterprise > Usuarios de servicio**
2. Haz clic en **Crear usuario de servicio**
3. Elige un nombre (p. ej., "Panel de analítica", "Bot de aprovisionamiento de organizaciones")
4. Asigna un rol de Enterprise con los permisos que tu integración necesite

<div id="organization-service-user-single-org-access">
  ### Usuario de servicio de organización (acceso a una sola organización)
</div>

1. Ve a **Settings > Service users** dentro de la organización de destino
2. Haz clic en **Create service user**
3. Elige un nombre y asigna un rol a nivel de organización

<Tip>
  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.
</Tip>

<div id="step-2-generate-an-api-key">
  ## Paso 2: Generar una API key
</div>

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

```bash theme={null}
export DEVIN_API_KEY="cog_your_key_here"
```

<div id="step-3-make-your-first-api-call">
  ## Paso 3: Realizar tu primera llamada a la API
</div>

<div id="enterprise-endpoint-example">
  ### Ejemplo de endpoint de Enterprise
</div>

Enumera todas las organizaciones de tu cuenta Enterprise:

```bash theme={null}
curl "https://api.devin.ai/v3/enterprise/organizations" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<div id="organization-endpoint-example">
  ### Ejemplo de endpoint de organización
</div>

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

```bash theme={null}
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"}'
```

<div id="permissions-and-rbac">
  ## Permisos y RBAC
</div>

Cada endpoint de la API 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](/es/api-reference/v3/overview#enterprise-permissions).

<div id="common-enterprise-workflows">
  ## Flujos de trabajo empresariales habituales
</div>

<div id="monitor-consumption-across-orgs">
  ### Supervisar el consumo en todas las organizaciones
</div>

```bash theme={null}
# 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"
```

<div id="audit-log-retrieval">
  ### Consulta del registro de auditoría
</div>

```bash theme={null}
curl "https://api.devin.ai/v3/enterprise/audit-logs" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

<div id="manage-users-across-organizations">
  ### Administrar usuarios entre organizaciones
</div>

```bash theme={null}
# 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"
```

<div id="next-steps">
  ## Próximos pasos
</div>

* Consulta la [referencia completa de permisos de la API](/es/api-reference/v3/overview)
* Obtén información detallada sobre la [autenticación](/es/api-reference/authentication)
* Configura la [paginación](/es/api-reference/concepts/pagination) para conjuntos de resultados grandes
* Revisa la [guía de migración](/es/api-reference/getting-started/migration-guide) si migras desde v1/v2