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.

​
2026

​
Febrero de 2026
Actualizaciones de la API v3
  • 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 horarios a nivel de organización: POST /v3beta1/organizations/{org_id}/schedules para crear horarios, GET /v3beta1/organizations/{org_id}/schedules para listar horarios, GET /v3beta1/organizations/{org_id}/schedules/{schedule_id} para recuperar un horario específico, PATCH /v3beta1/organizations/{org_id}/schedules/{schedule_id} para actualizar horarios y DELETE /v3beta1/organizations/{org_id}/schedules/{schedule_id} para eliminar horarios. Requiere el permiso ManageOrgSchedules.
​
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.

​
2025

​
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 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 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
  • 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 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.
​
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.

​
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 para recibir asistencia con la migración: