Previsualizar el rollback de la aplicación
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"environment_changes": [
{ "key": "DISCORD_TOKEN", "change": "modified" },
{ "key": "NEW_FEATURE", "change": "removed" }
]
}
}
{
"response": {
"environment_changes": []
}
}
Releases
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.
GET
/
v1
/
apps
/
{id}
/
releases
/
{release_id}
/
rollback
Previsualizar el rollback de la aplicación
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"environment_changes": [
{ "key": "DISCORD_TOKEN", "change": "modified" },
{ "key": "NEW_FEATURE", "change": "removed" }
]
}
}
{
"response": {
"environment_changes": []
}
}
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 con
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:
restore_environment: true.
string
requerido
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.string
requerido
El ID de la release a la que harías rollback, tal como lo devuelve la lista de releases.
string
Si la aplicación pertenece a un workspace, el ID del workspace.
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 comoremoved.modified: ambas tienen la variable, con valores distintos.
apps:envs cuando se llama con una clave de API. Para un miembro de un workspace, requiere el permiso apps:envs.
Respuesta
object
{
"response": {
"environment_changes": [
{ "key": "DISCORD_TOKEN", "change": "modified" },
{ "key": "NEW_FEATURE", "change": "removed" }
]
}
}
{
"response": {
"environment_changes": []
}
}
Respuestas de error
string
Códigos de error posibles:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: Falta la cabeceraAuthorization, 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 scopeapps:envs(403).
string
Un mensaje descriptivo con más detalles sobre el error.
{
"code": "RELEASE_NOT_FOUND"
}
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.
Última modificación el 28 de octubre de 2026