> ## 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.

# Descripción general de la API

> Aprende a interactuar de forma programática con Devin usando nuestras API REST

La API de Devin te permite integrar Devin en tus aplicaciones, automatizar flujos de trabajo y crear herramientas potentes. Usa **usuarios de servicio** con control de acceso basado en roles para disponer de un acceso a la API seguro y auditable.

<div id="getting-started">
  ## Primeros pasos
</div>

<CardGroup cols={2}>
  <Card title="Inicio rápido de Teams" icon="rocket" href="/es/api-reference/getting-started/teams-quickstart">
    Para equipos y organizaciones estándar. Crea un usuario de servicio y realiza tu primera llamada a la API en minutos.
  </Card>

  <Card title="Inicio rápido de Enterprise" icon="building" href="/es/api-reference/getting-started/enterprise-quickstart">
    Para clientes Enterprise con RBAC, compatibilidad con múltiples organizaciones y permisos avanzados.
  </Card>
</CardGroup>

<Tip>
  **¿Qué opción debería elegir?** La mayoría de los clientes deberían empezar con el inicio rápido de Teams. Elige Enterprise si administras varias organizaciones, usas inicio de sesión único (SSO) o necesitas roles personalizados y RBAC.
</Tip>

<div id="api-structure">
  ## Estructura de la API
</div>

La API está organizada en dos ámbitos principales:

<div id="organization-api">
  ### API de organización
</div>

**URL base:** `https://api.devin.ai/v3/organizations/*`

Para gestionar recursos dentro de una única organización — sesiones, Knowledge, playbooks, secretos y más. Aquí es donde se inician la mayoría de las integraciones.

<div id="enterprise-api">
  ### API Enterprise
</div>

**URL base:** `https://api.devin.ai/v3/enterprise/*`

Para la administración entre organizaciones: analítica, registros de auditoría, gestión de usuarios, facturación e infraestructura. Disponible para clientes Enterprise.

Ambos scopes usan credenciales de usuario de servicio (prefijo `cog_`). Consulta [Authentication](/es/api-reference/authentication) para la configuración.

<div id="session-attribution">
  ## Atribución de sesión
</div>

Los usuarios de servicio son identidades separadas de los usuarios humanos, pero puedes **crear sesiones en nombre de cualquier usuario** de tu organización con el parámetro `create_as_user_id`. Esto significa que las sesiones aparecen en la lista de sesiones de ese usuario y se contabilizan en su uso, como si las hubiera creado el propio usuario.

```bash theme={null}
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": "Fix the login bug in issue #42",
    "create_as_user_id": "user_abc123"
  }'
```

<Tip>
  **¿Vienes de usar API keys personales?** En v1/v2, las API keys personales creaban sesiones automáticamente como tu usuario. Con v3, usa un usuario de servicio + `create_as_user_id` para obtener el mismo comportamiento, con el beneficio adicional de RBAC, registros de auditoría y gestión centralizada de claves. El rol del usuario de servicio debe incluir el permiso `ImpersonateOrgSessions`.
</Tip>

<Note>
  **Personal Access Tokens (PATs) próximamente.** Los PATs te permitirán autenticarte directamente como tu usuario con la API v3, sin necesidad de un usuario de servicio ni de `create_as_user_id`. Las sesiones se te atribuirán automáticamente. Mantente atento a su disponibilidad.
</Note>

Puedes encontrar los IDs de usuario mediante el endpoint [List users](/es/api-reference/v3/users/organizations-members-users) o en la interfaz de Devin, en la configuración de miembros de la organización.

<div id="legacy-apis-v1-and-v2">
  ## API heredadas (v1 y v2)
</div>

Las API v1 y v2 continúan funcionando durante el período de deprecación, pero ya no recibirán nuevas funcionalidades. Recomendamos migrar a la API actual para disponer de control de acceso basado en roles, atribución de sesiones y nuevas capacidades.

* [Documentación de la API v1](/es/api-reference/v1/overview) — gestión de sesiones con API keys heredadas
* [Documentación de la API v2](/es/api-reference/v2/overview) — gestión Enterprise con API keys heredadas
* [Guía de migración](/es/api-reference/getting-started/migration-guide) — migración paso a paso desde v1/v2

***

<div id="error-handling">
  ## Manejo de errores
</div>

Todas las API usan códigos de estado HTTP estándar:

* `200 OK`: Solicitud exitosa
* `201 Created`: Recurso creado correctamente
* `400 Bad Request`: Parámetros de la solicitud no válidos
* `401 Unauthorized`: Falta la API key o no es válida
* `403 Forbidden`: Permisos insuficientes
* `404 Not Found`: Recurso no encontrado
* `429 Too Many Requests`: Se superó el límite de solicitudes
* `500 Internal Server Error`: Error del servidor

<div id="support">
  ## Soporte
</div>

Si tienes preguntas sobre la API o deseas informar de algún problema, escribe a [support@cognition.ai](mailto:support@cognition.ai).