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

# Notas de la versión de la API

> Sigue los cambios, las nuevas funcionalidades y las mejoras de las APIs de Devin

Esta página registra los cambios específicos de las APIs de Devin (v1, v2 y v3). Para ver las novedades de la aplicación, consulta las [notas de la versión de la aplicación](/es/release-notes/overview).

<div id="2026">
  ## 2026
</div>

<Update label="Junio de 2026">
  **Actualizaciones de la API v3**

  * **Endpoint para agregar IP a la lista de acceso IP**: Se agregó `POST /v3/enterprise/ip-access-list` para añadir rangos de IP a la lista de acceso IP de Enterprise sin reemplazar las entradas existentes. A diferencia de `PUT /v3/enterprise/ip-access-list` (que reemplaza la lista completa), este endpoint combina los rangos proporcionados con la lista actual. Requiere el permiso `ManageEnterpriseSettings`.

  * **Endpoint para actualizar permisos de git**: Se agregó `PATCH /v3/enterprise/organizations/{org_id}/git-providers/permissions/{git_permission_id}` para actualizar un permiso de git existente (p. ej., cambiar `read_only`). Requiere el permiso `ManageGitIntegrations`.

  * **Endpoints de lectura de miembros con ámbito de organización (Beta)**: Se agregaron `GET /v3beta1/organizations/{org_id}/members/users`, `GET /v3beta1/organizations/{org_id}/members/users/{user_id}` y `GET /v3beta1/organizations/{org_id}/members/idp-users` para listar y recuperar miembros de la organización con un usuario de servicio de ámbito de organización. Admiten paginación basada en cursor (`after`, `first`) y filtrado por `email`. Requiere el permiso `ViewOrgMembership` a nivel de organización.

  * **Modo Devin Lite para la creación de sesiones**: El parámetro `devin_mode` en `POST /v3/organizations/{org_id}/sessions` ahora también acepta `"lite"` (Devin Lite), además de `"normal"` y `"fast"`. Los modos Fast y Lite están sujetos a las mismas restricciones de feature flag y de vista previa de agentes de Enterprise que la aplicación web.
</Update>

<Update label="Mayo de 2026">
  **Actualizaciones de la API v3**

  * **Parámetro `devin_mode` para la creación de sesiones (21 de mayo)**: Se agregó el parámetro `devin_mode` a `POST /v3/organizations/{org_id}/sessions`. Acepta `"normal"` (modo Agent predeterminado) o `"fast"` (modo Fast). Si se omite, la sesión usa el modo predeterminado de la organización. El modo Fast está sujeto a las mismas restricciones de feature flag y de vista previa de agentes de Enterprise que la aplicación web.

  * **Endpoint de repositorios de conexiones Git (18 de mayo)**: Se agregó `GET /v3/enterprise/git-providers/connections/{connection_id}/repositories` para listar los repositorios disponibles para una conexión Git de Enterprise específica. Admite filtrado por `filter_name` y paginación basada en cursor (`after`, `first`). Requiere el permiso `ManageGitIntegrations`.
</Update>

<Update label="Marzo de 2026">
  **Actualizaciones de la API v3**

  * **Endpoint de generación de insights de sesión (11 de marzo)**: Se agregaron los endpoints `POST /v3/organizations/{org_id}/sessions/{devin_id}/insights/generate` y `POST /v3/enterprise/sessions/{devin_id}/insights/generate` para activar la generación de insights de sesión a demanda. Devuelven `{ "status": "started" }` cuando comienza la generación, o `{ "status": "already_exists" }` si los insights ya se generaron o están en curso. Consulta el endpoint GET de insights existente para recuperar los resultados. Requiere el permiso `ManageOrgSessions`.
</Update>

<Update label="Febrero de 2026">
  **Actualizaciones de la API v3**

  * **Endpoints de v3 promovidos a prod**: Los siguientes grupos de endpoints se han promovido de `v3beta1` a `v3` (producción). Actualiza tus URLs base de `/v3beta1/` a `/v3/` para estos endpoints:

    * sesiones (create, list, get, messages, archive, terminate, tags, insights), tanto en el alcance de Enterprise como de organización
    * Knowledge notes, tanto en el alcance de Enterprise como de organización
    * Playbooks, tanto en el alcance de Enterprise como de organización
    * secretos, alcance de organización
    * programación, alcance de organización
    * Attachments, alcance de organización
    * Audit logs, tanto en el alcance de Enterprise como de organización
    * Consumption & billing (cycles, daily breakdowns, ACU limits), alcance de Enterprise
    * Metrics (DAU, WAU, MAU, PRs, sessions, searches, active users, usage), alcance de Enterprise
    * Organizations, users, members, roles, IDP groups, alcance de Enterprise
    * Git connections & permissions, alcance de Enterprise
    * Hypervisors, queue, IP access lists, org group limits, alcance de Enterprise
    * etiquetas de sesión (organization default tags), alcance de Enterprise

    **Siguen en beta** (`v3beta1`): Los endpoints de indexación de repositorios, de aprovisionamiento de usuarios de servicio y de infracciones de guardrails permanecen en `v3beta1` y están marcados con una etiqueta Beta en la documentación.

  * **Endpoint de infracciones de guardrails**: Se agregaron los endpoints `GET /v3beta1/enterprise/guardrail-violations` y `GET /v3beta1/enterprise/organizations/{org_id}/guardrail-violations` para consultar infracciones de guardrails en toda la Enterprise. Devuelven detalles de las infracciones, incluido el tipo de guardrail, el razonamiento, la puntuación de confianza, la acción realizada y el mensaje que la desencadenó. Admiten filtrado por `session_id` y `guardrail_id`, con rango de tiempo y paginación basada en cursor. Usa el endpoint por organización para filtrar por organización. Requiere el permiso `ManageEnterpriseSettings`.

  * **Endpoints de listas de acceso IP (9 de febrero)**: Se agregaron los endpoints `GET /v3beta1/enterprise/ip-access-list`, `PUT /v3beta1/enterprise/ip-access-list` y `DELETE /v3beta1/enterprise/ip-access-list` para gestionar listas de IP permitidas de Enterprise. El endpoint PUT reemplaza la lista completa con los rangos de IP proporcionados (se admite notación CIDR). Requiere el permiso `ManageEnterpriseSettings`.

  * **Endpoints de sesiones programadas (3 de febrero)**: Se agregaron endpoints de gestión de programaciones a nivel de organización: `POST /v3beta1/organizations/{org_id}/schedules` para crear programaciones, `GET /v3beta1/organizations/{org_id}/schedules` para listar programaciones, `GET /v3beta1/organizations/{org_id}/schedules/{schedule_id}` para recuperar una programación específica, `PATCH /v3beta1/organizations/{org_id}/schedules/{schedule_id}` para actualizar programaciones y `DELETE /v3beta1/organizations/{org_id}/schedules/{schedule_id}` para eliminar programaciones. Requiere el permiso `ManageOrgSchedules`.
</Update>

<Update label="Enero de 2026">
  **Actualizaciones de la API v3**

  * **Endpoints de límites de ACU (27 ene)**: Se agregaron endpoints de gestión de límites de ACU de Enterprise para sesiones de Devin: `GET /v3beta1/enterprise/consumption/acu-limits/devin` para recuperar los límites, `PUT .../organizations/{org_id}` para establecer límites a nivel de organización y `DELETE` para eliminar los límites. Requiere el permiso `ManageBilling`.

  * **Endpoints de archivos adjuntos (27 ene)**: Se agregaron endpoints de archivos adjuntos a nivel de organización: `POST /v3beta1/organizations/{org_id}/attachments` para cargar archivos adjuntos y `GET /v3beta1/organizations/{org_id}/attachments/{uuid}/{name}` para descargar archivos adjuntos. La carga requiere el permiso `UseDevinSessions`, la descarga requiere el permiso `ViewOrgSessions`.

  * **Endpoint de cola (21 ene)**: Se agregó el endpoint `GET /v3beta1/enterprise/queue` para que los administradores de Enterprise puedan supervisar la salud de la cola de sesiones. Devuelve el número total de sesiones en cola y un indicador de estado (`normal`, `elevated` o `high`). Es útil para configurar alertas ante problemas de capacidad. Requiere el permiso `ViewAccountMetrics`.

  * **Endpoints de sesiones (19 de enero)**: Se agregaron los endpoints `GET /v3beta1/enterprise/sessions/{devin_id}` y `GET /v3beta1/organizations/{org_id}/sessions/{devin_id}` para obtener los detalles de una sesión específica. También se agregaron los endpoints `POST /v3beta1/enterprise/sessions/{devin_id}/messages` y `POST /v3beta1/organizations/{org_id}/sessions/{devin_id}/messages` para enviar mensajes a sesiones activas (las sesiones se reanudan automáticamente si están suspendidas). También se agregó el parámetro de filtro `origins` a los endpoints de lista de sesiones para filtrar por el origen de la sesión (`webapp`, `slack`, `teams`, `api`, `linear`, `jira`, `other`).

  * **Parámetro de orden en los registros de auditoría (17 de ene)**: Se agregó el parámetro de consulta `order` (`asc` o `desc`, con valor predeterminado `desc`) a los endpoints de registros de auditoría de Enterprise y de organización para controlar el orden de los resultados.

  * **Router de secretos (16 ene)**: Se añadieron endpoints de gestión de secretos a nivel de organización: `GET /v3beta1/organizations/{org_id}/secrets` para listar secretos, `POST /v3beta1/organizations/{org_id}/secrets` para crear secretos y `DELETE /v3beta1/organizations/{org_id}/secrets/{secret_id}` para eliminar secretos. Requiere el permiso `ManageOrgSecrets`.

  * **Corrección de registros de auditoría (15 de enero)**: Se corrigió un problema en el que `end_cursor` no se devolvía en las respuestas de la API de registros de auditoría cuando la página contenía elementos.

  * **Provisionamiento de usuarios de servicio (14 de ene.)**: Se añadieron los endpoints `POST /v3beta1/enterprise/service-users` y `POST /v3beta1/organizations/{org_id}/service-users` para crear de forma programática nuevos usuarios de servicio. Aplica prevención de escalada de privilegios: los permisos del rol de destino deben ser un subconjunto de los permisos del llamante, y los permisos `ManageServiceUsers` nunca pueden concederse. Requiere el permiso `ManageAccountServiceUsers` o `ManageOrgServiceUsers`, respectivamente.

  * **Endpoints a nivel de Enterprise para grupos de IDP (14 de enero)**: Se agregó `GET /v3beta1/enterprise/idp-groups` para listar los grupos de IDP registrados en una cuenta Enterprise, `POST /v3beta1/enterprise/idp-groups` para registrar de forma masiva grupos de IDP (hasta 100 a la vez) y `DELETE /v3beta1/enterprise/idp-groups/{idp_group_name}` para eliminar un grupo de IDP registrado. No se pueden eliminar grupos con asignaciones de roles existentes o membresías de usuarios. Requiere el permiso `ManageAccountMembership`.

  * **Acciones del registro de auditoría (12 de enero)**: Se agregaron los tipos de acción `create_join_request`, `automatic_join_event` y `reject_join_request` en las respuestas del registro de auditoría.

  * **Endpoint de usuarios activos (8 de enero)**: Se agregó el endpoint `GET /v3beta1/enterprise/metrics/active-users` para obtener usuarios activos únicos en un rango de fechas personalizado. A diferencia de los endpoints DAU/WAU/MAU, que devuelven listas desglosadas por período, este endpoint devuelve un único recuento de usuarios activos únicos en todo el rango especificado. Admite filtrado por identificadores de organización y umbrales de actividad configurables (`min_sessions`, `min_searches`).

  * **Estado predeterminado de los hipervisores (8 de enero)**: El endpoint `GET /v3beta1/enterprise/hypervisors` ahora, de forma predeterminada, filtra por el estado `available` en lugar de devolver todos los hipervisores. Incluye `status=all` para obtener hipervisores independientemente de su estado.

  * **Secretos de sesión (5 ene)**: Se agregó el parámetro `session_secrets` al endpoint de creación de sesiones (`POST /v3beta1/organizations/{org_id}/sessions`). Los secretos de sesión son secretos temporales disponibles solo dentro de la sesión actual y no se almacenan en los secretos de la organización.

  * **Corrección de paginación (5 de enero)**: Se corrigió un error en la paginación de la API de Usuarios de Enterprise v3 donde `end_cursor` no siempre se devolvía correctamente.

  **Actualizaciones de la API v2**

  * **Corrección en la clonación de repositorios (20 de enero)**: Se corrigió el esquema del endpoint `POST /v2/enterprise/organizations/{org_id}/clone-repository`. Se eliminó el formato heredado `RepoSetupStepsT` y se simplificó el cuerpo de la solicitud para que use campos planos (`pull_repo_commands`, `run_lint_commands`, `run_project_commands`, `update_dependencies_commands`, `repo_note`, `repo_path`).

  * **Campos de URL de permisos de Git (15 ene)**: Se agregaron los campos `group_prefix_url` y `repo_url` al esquema `GitPermissionRequest`, proporcionando alternativas con URL completas para la coincidencia de repositorios y prefijos de grupo basada en rutas.

  * **Campo de rol de miembro de la organización (8 de ene)**: Se agregó el campo `org_role_name` a la respuesta de `GET /v2/enterprise/organizations/{org_id}/members`, que muestra el rol de cada miembro dentro de la organización.

  * **Opción de creación de organización (8 ene)**: Se agregó el parámetro booleano `add_creator_as_member` (establecido en `true` de forma predeterminada) a `POST /v2/enterprise/organizations`, lo que permite a los administradores de Enterprise crear organizaciones sin que se les añada automáticamente como miembros.

  * **Documentación sobre la zona horaria de consumo (7 de enero)**: Se agregó documentación sobre el comportamiento de la zona horaria para los endpoints de consumo diario. Los ciclos de facturación usan la medianoche, hora del Pacífico (PST) (08:00:00 UTC), como límite del día.

  **Actualizaciones de la API v1**

  * **Actualización de tipos de secretos (16 de enero)**: Se agregó `dictionary` como un valor de tipo de secreto reconocido en el esquema de la API de secretos. Nota: la creación de secretos con tipo `dictionary` está obsoleta; usa `cookie`, `key-value` o `totp` en su lugar.
</Update>

<div id="2025">
  ## 2025
</div>

<Update label="Diciembre de 2025">
  **Actualizaciones de la API v3**

  * **Endpoint de límites de grupos de organizaciones (23 dic)**: Se agregaron los endpoints `GET /v3beta1/enterprise/org-group-limits` y `PUT /v3beta1/enterprise/org-group-limits` para gestionar las configuraciones de grupos de organizaciones. Los grupos asignan conjuntos de ID de organización a límites máximos opcionales de Agent Compute Unit por ciclo de facturación. Requiere el permiso `ManageOrganizations`. *Esta funcionalidad requiere habilitación por parte de tu equipo de cuentas.*
  * **Endpoint de archivado de sesiones (11 dic)**: Se agregó el endpoint `POST /v3beta1/organizations/{org_id}/sessions/{devin_id}/archive` para archivar sesiones. También se agregó el parámetro de consulta `archive` a `DELETE /v3beta1/organizations/{org_id}/sessions/{devin_id}` (terminar sesión) y el campo `is_archived` a las respuestas de sesión.
  * **Eliminación del parámetro order (11 dic)**: **Cambio incompatible:** Se eliminó el parámetro de consulta `order` del endpoint de listado de sesiones (`GET /v3beta1/organizations/{org_id}/sessions`). Los clientes deben dejar de enviar `order`; en su lugar, deben utilizar paginación basada en cursor con los parámetros `first`/`after`.
  * **Router de búsquedas (10 dic)**: Se agregaron endpoints de búsqueda a nivel de Enterprise y de organización en `GET /v3beta1/enterprise/searches` y `GET /v3beta1/organizations/{org_id}/searches` para listar búsquedas con paginación y filtrado.
  * **Mejoras en audit logs (10 dic)**: Se agregaron el objeto `data` y los campos `service_user_name` y `user_email` a las respuestas de audit logs. Se agregó el tipo de acción `update_git_permission`.
  * **Compatibilidad con sesiones avanzadas (8 dic)**: Se agregaron nuevos parámetros de solicitud para flujos de trabajo de sesiones avanzadas: `child_playbook_id`, `session_links` y `bypass_approval`. Las respuestas de sesión ahora incluyen los campos `child_session_ids`, `parent_session_id` e `is_advanced`.
  * **Router de etiquetas de sesión (5 dic)**: Se agregaron endpoints CRUD en `/v3/beta/enterprise/organizations/{org_id}/tags` para gestionar las etiquetas de sesión permitidas por organización. Cuando la validación de etiquetas está habilitada, la creación de sesiones y las actualizaciones de etiquetas obligan a usar etiquetas de la lista permitida.
  * **Endpoint de sesiones de Enterprise (5 dic)**: Se agregó `GET /v3/beta/enterprise/sessions` para listar sesiones en toda la cuenta Enterprise con filtrado opcional por `org_ids`.
  * **Actualizaciones de permisos de Git (5 dic)**: Se agregó el campo `prefix_path` para hacer coincidir repositorios por prefijo de ruta. Se agregaron endpoints `PUT` y `DELETE` para reemplazar en bloque o borrar todos los permisos de una organización.
  * **Impersonación de sesión (5 dic)**: Se agregó el parámetro `create_as_user_id` al endpoint de creación de sesiones, lo que permite que usuarios de servicio creen sesiones en nombre de otros usuarios.
  * **Cambio en la respuesta de hypervisors (5 dic)**: La respuesta del endpoint de hypervisors ahora devuelve `utilization_percentage` en lugar de `max_slots` y `available_slots`.
  * **Routers de Notes y Playbooks (1 dic)**: Se agregaron endpoints de gestión de Notes y Playbooks a nivel de Enterprise y de organización a la API v3. Los endpoints de Notes requieren el permiso `ManageAccountKnowledge`, los endpoints de Playbooks requieren el permiso `ManageAccountPlaybooks`.

  **Actualizaciones de la API v2**

  * **Endpoint de límites de grupos de organizaciones (23 dic)**: Se agregaron los endpoints `GET /v2/enterprise/org-group-limits` y `PUT /v2/enterprise/org-group-limits` para gestionar las configuraciones de grupos de organizaciones. Los grupos asignan conjuntos de ID de organización a límites máximos opcionales de Agent Compute Unit por ciclo de facturación. El endpoint PUT reemplaza toda la configuración (los grupos que no estén en la solicitud se eliminan). *Esta funcionalidad requiere habilitación por parte de tu equipo de cuentas.*
  * **Endpoint self (23 dic)**: Se agregó el endpoint `GET /v2/enterprise/self` que devuelve información sobre la API key autenticada, incluido el ID de la clave, el ID de usuario asociado, el correo electrónico del usuario y el ID de la organización.
  * **Campo de mensajes de sesiones (11 dic)**: Se agregó el campo `messages` a la respuesta de la API de sesiones v2, que proporciona todos los mensajes de la sesión de forma similar a la API v1.
  * **Mejoras en los esquemas de respuesta (11 dic)**: Se agregaron esquemas de respuesta adecuados para los endpoints de audit logs, snapshots y playbooks, incluidos `AuditLogsResponse`, `EnterpriseSnapshotResponse` y `EnterprisePlaybookResponse`.

  **Actualizaciones de la API v1**

  * **Obsolescencia de audit logs (5 dic)**: El endpoint `/v1/audit-logs` se ha retirado; usa en su lugar los endpoints de audit logs de v2 o v3.
</Update>

<Update label="Noviembre de 2025">
  **Actualizaciones de la API Enterprise v2**

  * **Actualización del límite de paginación (21 nov)**: El límite máximo de paginación se redujo de 1000 a 200 elementos por solicitud para mejorar el rendimiento y la confiabilidad. El límite predeterminado sigue siendo 100. Este cambio NO afecta a la API externa v1.
  * **Router de sesiones (16 nov)**: Se agregaron endpoints completos de gestión de sesiones a la API v2 para administradores de Enterprise.
  * **Endpoint de la API de snapshots (3 nov)**: Se agregó un endpoint para obtener detalles de snapshots de forma programática.

  **Actualizaciones de la API v1**

  * **Endpoint para terminar sesiones (31 oct)**: Se agregó un endpoint para finalizar sesiones en ejecución de forma programática.
</Update>

<Update label="Octubre de 2025">
  **Lanzamiento de la API v3 (Beta)**

  * **Lanzamiento de la API v3 (23 oct)**: Se lanzó la API v3 con soporte completo de RBAC, modelo de autenticación para usuarios de servicio y registro de auditoría completo para las acciones de usuarios de servicio.

  **Actualizaciones de la API Enterprise v2**

  * **Endpoint de creación de snapshots (30 oct)**: Nuevo endpoint de la API Enterprise Organizations v2 para que los administradores de Enterprise clonen repositorios de forma programática y creen snapshots con pasos de configuración personalizados y comandos de arranque.
  * **Mejoras en la API de Playbooks (14 oct)**: Se agregó una API para publicar playbooks de Enterprise con funcionalidad mejorada para la gestión programática de playbooks.
</Update>

<Update label="Septiembre de 2025">
  **Actualizaciones de la API Enterprise v2**

  * **Router de roles (25 sep)**: Se agregó un router de roles de Enterprise con cinco endpoints de API para gestionar roles de forma programática.

  **Actualizaciones de la API v1**

  * **API de Playbooks (6 sep)**: Se agregaron endpoints completos de la API de Playbooks a la v1 para crear, actualizar, listar y eliminar playbooks de forma programática.
  * **Endpoint de secretos (5 sep)**: Se agregó el nuevo endpoint `POST /v1/secrets` para crear secretos mediante la API.
</Update>

<Update label="Marzo de 2025">
  **Lanzamiento de la API Enterprise v2**

  * **Lanzamiento de la API v2 (23 mar)**: Se lanzó la API Enterprise v2 para administradores de Enterprise con capacidades de gestión de organizaciones, seguimiento del consumo y gestión de miembros.
</Update>

<div id="2024">
  ## 2024
</div>

<Update label="Octubre de 2024">
  **Lanzamiento de la API v1 (26 de oct)**

  * Lanzamos una API REST para la creación y administración programática de sesiones
  * Endpoints para la creación, supervisión y administración de sesiones
  * Compatibilidad con carga y descarga de archivos adjuntos
  * Autenticación básica con API keys
  * Compatibilidad con la creación idempotente de sesiones
  * Casos de uso: revisiones automáticas de pull requests (PR), resolución de errores de lint, migraciones
</Update>

***

<div id="api-versioning-policy">
  ## Política de versionado de API
</div>

<div id="backward-compatibility">
  ### Compatibilidad con versiones anteriores
</div>

Nos esforzamos por mantener la compatibilidad con versiones anteriores dentro de las versiones principales. Los cambios que rompan la compatibilidad serán:

1. Anunciados con al menos 7 días de anticipación
2. Documentados en estas notas de la versión
3. Acompañados de guías de migración cuando corresponda

<div id="deprecation-process">
  ### Proceso de obsolescencia
</div>

Cuando marcamos como obsoleta una funcionalidad de la API:

1. **Anuncio**: Anunciaremos la obsolescencia con un cronograma
2. **Período de obsolescencia**: La funcionalidad sigue disponible, pero marcada como obsoleta
3. **Eliminación**: La funcionalidad se elimina después del período de obsolescencia

<div id="version-support">
  ### Compatibilidad con versiones
</div>

* **v1**: Versión heredada; se retirará pronto en favor de la Organization API (v3)
* **v2**: Versión heredada; se retirará pronto en favor de la Enterprise API (v3)
* **v3**: De disponibilidad general, recomendada para todas las integraciones nuevas

***

<div id="migrating-to-the-current-api">
  ## Migración a la API actual
</div>

Para obtener instrucciones paso a paso para migrar desde v1 o v2, consulta la [guía de migración](/es/api-reference/getting-started/migration-guide).

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

Para consultas sobre cambios en la API o para recibir asistencia con la migración, envía un correo electrónico a [support@cognition.ai](mailto:support@cognition.ai).