> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Previsualizar el rollback de la aplicación

> Previsualiza qué variables de entorno añadiría, cambiaría o eliminaría un rollback a esta release, solo con nombres y tipos de cambio, nunca valores.

Devuelve qué variables de entorno cambiarían si hicieras rollback de la aplicación a esta release y restauraras sus variables. Solo se devuelven los nombres de las variables y el tipo de cambio, nunca los valores. No se cambia nada.

Un rollback no restaura las variables a menos que lo pidas. Revisa primero esta previsualización y, si los cambios son los que quieres, envía la petición de [rollback](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/releases/rollback.md) con `restore_environment: true`.

**id** `string` *required*

El ID de la aplicación. Si la aplicación pertenece a un workspace, pasa su ID en el parámetro de consulta `workspace_id`.

**release\_id** `string` *required*

El ID de la release a la que harías rollback, tal como lo devuelve la [lista de releases](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/releases/list.md).

**workspace\_id** `string`

Si la aplicación pertenece a un workspace, el ID del workspace.

Cada cambio se compara con las variables actuales de la aplicación, incluidas las guardadas que todavía no ha aplicado un reinicio. Esas son las variables que sobrescribe un rollback:

* `added`: la release tiene la variable, y las variables actuales no.
* `removed`: las variables actuales tienen la variable, y la release no. Una variable creada después de la release y que todavía no ha aplicado un reinicio aparece como `removed`.
* `modified`: ambas tienen la variable, con valores distintos.

La lista se ordena por clave. Está vacía cuando la release no tiene variables guardadas, o cuando restaurarlas no cambiaría nada.

Requiere el scope `apps:envs` cuando se llama con una clave de API. Para un miembro de un workspace, requiere el permiso `apps:envs`.

### Respuesta

**response** `object`

Los cambios de variables que haría un rollback.

**Mostrar objeto**

**environment\_changes** `object[]`

Las variables que cambiarían. Cada elemento tiene:

**Mostrar objeto**

**key** `string`

El nombre de la variable. El valor nunca se devuelve.

**change** `string`

`added`, `modified` o `removed`.

```json Response theme={null}
{
  "response": {
    "environment_changes": [
      { "key": "DISCORD_TOKEN", "change": "modified" },
      { "key": "NEW_FEATURE", "change": "removed" }
    ]
  }
}
```

```json Response (nothing to change) theme={null}
{
  "response": {
    "environment_changes": []
  }
}
```

### Respuestas de error

**code** `string`

Códigos de error posibles:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: Falta la cabecera `Authorization`, la clave de API no es válida o la sesión del panel fue revocada (`401`).
* `API_KEY_IP_DENIED`: La clave de API se usa desde una IP fuera de su lista de permitidas (`403`).
* `APP_NOT_FOUND`: La aplicación no existe, o no pertenece a esta cuenta ni a este workspace (`404`).
* `RELEASE_NOT_FOUND`: La release no existe, o pertenece a otra aplicación (`404`).
* `PLAN_DOES_NOT_SUPPORT_ROLLBACK`: Tu plan no incluye hacer rollback a releases anteriores (`403`). El rollback empieza en Pro.
* `API_KEY_SCOPE_DENIED`: La clave de API no tiene el scope `apps:envs` (`403`).

**message** `string`

Un mensaje descriptivo con más detalles sobre el error.

```json theme={null}
{
  "code": "RELEASE_NOT_FOUND"
}
```

> [!NOTE]
>
> Una release conserva las variables con las que se arrancó la aplicación. Las releases creadas antes de lanzar esta función no tienen ninguna guardada, así que su previsualización siempre está vacía.


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