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

<h2 id="2026">
  2026
</h2>

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

  * **Endpoints de repositorios y de snapshot-setup promovidos a v3**: Los [endpoints de repositorios](/es/api-reference/v3/repositories/list-organizations-repositories) de la organización (`/v3/organizations/{org_id}/repositories`) y los [endpoints de snapshot-setup](/es/api-reference/v3/snapshot-setup/list-organizations-blueprints) de la organización y de Enterprise para blueprints, archivos de blueprint y compilaciones (`/v3/organizations/{org_id}/snapshot-setup` y `/v3/enterprise/snapshot-setup`) ahora forman parte de la API v3 estable. La estructura de las solicitudes y respuestas no cambia, salvo que las respuestas de repositorios ahora incluyen el campo `repo_full_name`: el identificador que debe pasarse como `repository_path` a los endpoints de indexación y de blueprints. Las rutas `/v3beta1` siguen funcionando para los clientes existentes. Los endpoints de sincronización de snapshot-setup permanecen en `v3beta1`.
</Update>

<Update label="Septiembre de 2026">
  **Obsolescencias de la API v3**

  * **Endpoints de programación deprecados (10 de septiembre)**: Los endpoints de programaciones de la organización (`GET`/`POST /v3/organizations/{org_id}/schedules` y `GET`/`PATCH`/`DELETE /v3/organizations/{org_id}/schedules/{schedule_id}`) quedan deprecados en favor de [automatizaciones](/es/api-reference/v3/automations/post-organizations-automations). Crea el trabajo programado como una automatización con un trigger `schedule:recurring` (una `RRULE` de iCalendar, evaluada en UTC) y una acción `start_session`. **A partir del 24 de septiembre de 2026, `POST /v3/organizations/{org_id}/schedules` devuelve `403` para las organizaciones migradas a automatizaciones**; los endpoints de lectura, actualización y eliminación siguen funcionando para las programaciones existentes. Las organizaciones que todavía están en proceso de migración conservan la creación de programaciones hasta que su migración se complete. Las programaciones existentes se convertirán en automatizaciones en una fase posterior; la respuesta `GET` de una programación convertida apuntará a la automatización que la reemplaza. El recurso de Terraform `devin_schedule` queda deprecado en favor de `devin_automation`.
</Update>

<Update label="Agosto de 2026">
  **Actualizaciones de la API v2**

  * **Endpoint de clonación de repositorio retirado**: Se eliminó `POST /v2/enterprise/organizations/{org_id}/clone` junto con el sistema heredado de instantáneas predeterminadas de la organización que alimentaba, y ahora devuelve `410 Gone`. En su lugar, gestiona los entornos de repositorio con [blueprints de entorno y compilaciones de instantáneas](/es/enterprise/environment-management/overview), mediante la API beta `/v3beta1/organizations/{org_id}/snapshot-setup`: [crea un blueprint del repo](/es/api-reference/v3/snapshot-setup/post-organizations-blueprints) y, después, [activa una compilación](/es/api-reference/v3/snapshot-setup/post-organizations-builds).

  **Actualizaciones de la API v3**

  * **Nuevos endpoints de automatizaciones**: Se agregaron endpoints de automatizaciones con ámbito de organización a la API v3:

    * `GET /v3/organizations/{org_id}/automations` — listar automatizaciones (filtros de búsqueda, creador, habilitación, tipo de evento, tipo de agente y metadatos)
    * `POST /v3/organizations/{org_id}/automations` — crear una automatización
    * `GET /v3/organizations/{org_id}/automations/{automation_id}` — obtener una automatización
    * `PATCH /v3/organizations/{org_id}/automations/{automation_id}` — actualizar una automatización (semántica de combinación por miembros)
    * `DELETE /v3/organizations/{org_id}/automations/{automation_id}` — eliminar de forma reversible una automatización
    * `GET /v3/organizations/{org_id}/automations/schemas` — esquemas compatibles de eventos de activación, operadores de condición y verbos de respuesta
    * `GET /v3/organizations/{org_id}/automations/templates` — plantillas de automatización integradas

    Las operaciones de lectura requieren `ViewOrgAutomations` y las de escritura requieren `ManageOrgAutomations`. Las automatizaciones deben estar habilitadas para la organización.
</Update>

<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 de modo Devin 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 de agente 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 conexión 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 específica de Enterprise. 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 para generar información de la 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 bajo demanda la generación de información de la sesión. Devuelve `{ "status": "started" }` cuando comienza la generación, o `{ "status": "already_exists" }` si la información ya se generó o está en curso. Consulta periódicamente el endpoint GET existente de insights para obtener 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>

<h2 id="2025">
  2025
</h2>

<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">
  <h2 id="2024">
    2024
  </h2>
</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">
  <h2 id="api-versioning-policy">
    Política de versionado de API
  </h2>
</div>

<div id="backward-compatibility">
  <h3 id="backward-compatibility">
    Compatibilidad con versiones anteriores
  </h3>
</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">
  <h3 id="deprecation-process">
    Proceso de obsolescencia
  </h3>
</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

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

* **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

***

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

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

<h2 id="support">
  Soporte
</h2>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.