Saltar al contenido principal
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.

​
2025

​
Diciembre de 2025
Actualizaciones de la API v3
  • 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.
  • Compatibilidad con sesiones avanzadas (8 dic): Se agregó compatibilidad con modos avanzados de sesión (analyze, create, improve, batch, manage) con nuevos parámetros de solicitud: advanced_mode, 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 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.
  • 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
  • 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
  • Retirada 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.
​
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.
​
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.
​
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 v1 para crear, actualizar, listar y eliminar playbooks de forma programática.
  • Endpoint de secrets (5 sep): Se agregó el nuevo endpoint POST /v1/secrets para crear secrets mediante la API.
​
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 funcionalidades de gestión de organizaciones, seguimiento de consumo y gestión de miembros.

​
2024

​
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

​
Política de versionado de API

​
Compatibilidad con versiones anteriores

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

​
Proceso de obsolescencia

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

​
Compatibilidad de versiones

  • v1: Disponible de forma general, con mantenimiento activo
  • v2: Disponible de forma general, con mantenimiento activo
  • v3: Beta: sujeta a cambios, aún no se recomienda para uso en producción

​
Guías de migración

​
Migrar de v1 a v3

Si estás creando nuevas integraciones que requieren permisos granulares, considera usar v3 en lugar de v1: Diferencias clave:
  • Autenticación: v3 requiere tokens de usuario de servicio en lugar de API keys personales/de servicio
  • Autorización: v3 proporciona control de acceso basado en roles (RBAC) con permisos detallados por rol
  • Endpoints: v3 usa diferentes patrones de URL (/v3beta1/* en lugar de /v1/*)
Pasos de migración:
  1. Crea un usuario de servicio en Enterprise Settings > Service Users
  2. Asigna los roles apropiados al usuario de servicio
  3. Genera una API key para el usuario de servicio
  4. Actualiza tu integración para usar los endpoints de v3
  5. Realiza pruebas exhaustivas en un entorno no productivo
Ver documentación de la API v3 →

​
Migrar de v2 a v3

v3 ofrece más flexibilidad que v2 para la automatización en Enterprise: Principales diferencias:
  • Autenticación: v3 utiliza usuarios de servicio en lugar de requerir claves personales de administradores de Enterprise
  • Autorización: v3 admite RBAC granular (control de acceso basado en roles) en lugar de acceso limitado solo a administradores de Enterprise
  • Alcance: v3 puede limitarse a organizaciones específicas; v2 siempre aplica a toda la cuenta Enterprise
Cuándo migrar:
  • Necesitas automatización con permisos que no sean de administrador
  • Quieres limitar el acceso a la API a organizaciones específicas
  • Necesitas una separación clara entre cuentas humanas y de servicio
  • Requieres registros de auditoría detallados para acciones automatizadas

​
Soporte

Para consultas sobre cambios en la API o asistencia con la migración: