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

​
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.
​
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:
    • Sessions (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
    • Secrets, alcance de organización
    • Schedules, 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
    • Session tags (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 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 con versiones

  • 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

​
Migración a la API actual

Para obtener instrucciones paso a paso para migrar desde v1 o v2, consulta la guía de migración.

​
Soporte

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.