> ## 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: Equipos

> Comienza a usar la Devin API como usuario de un equipo o de una organización estándar

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.

<Note>
  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](/es/api-reference/getting-started/enterprise-quickstart).
</Note>

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

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

<Tip>
  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.
</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 se mostrará de nuevo
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: Realiza tu primera llamada a la API
</div>

Crea una sesión de Devin:

```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": "Create a simple Python script that prints Hello World"}'
```

<Tip>
  Encuentra tu ID de organización en la página **Settings → Service Users**.
</Tip>

<Note>
  **¿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](/es/api-reference/overview#session-attribution) para más detalles.
</Note>

<div id="step-4-common-operations">
  ## Paso 4: Operaciones habituales
</div>

<div id="list-your-sessions">
  ### Listar tus sesiones
</div>

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

<div id="send-a-message-to-a-running-session">
  ### Enviar un mensaje a una sesión activa
</div>

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

<div id="manage-knowledge">
  ### Gestionar Knowledge
</div>

```bash theme={null}
# 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_description": "When writing code", "body": "Use TypeScript strict mode..."}'
```

<div id="permissions-for-teams-users">
  ## Permisos para usuarios de Teams
</div>

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](/es/api-reference/getting-started/enterprise-quickstart).

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

* Explora los endpoints de la **Organization API** en la barra lateral
* Consulta [flujos comunes](/es/api-reference/common-flows) para patrones de integración habituales
* Obtén información detallada sobre la [autenticación](/es/api-reference/authentication)
* Configura [sesiones programadas](/es/api-reference/v3/schedules/organizations-schedules) para tareas recurrentes