Hacer rollback de la aplicación a una release
curl --request POST \
--url https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"restore_environment": true
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({restore_environment: true})
};
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"
payload = { "restore_environment": True }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback"
payload := strings.NewReader("{\n \"restore_environment\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"id": "5b8e3f10-2c4a-4d9b-a7e1-0f3c6b9d2e54",
"app_id": "7a52e0d4-19b3-4f8e-b6c2-0d9e4a1f5c73",
"source": "rollback",
"status": "active",
"message": null,
"author": "octocat",
"github": null,
"files_changed": 4,
"rollback": {
"available": false,
"expires_at": null,
"from": "3f1c2a9e-8b7d-4c21-9e0a-5d6f7a8b9c01"
},
"has_log": false,
"build_duration_ms": 12450,
"first_started_at": "2026-10-11T15:02:50.000Z",
"created_at": "2026-10-11T15:02:37.000Z"
}
}
Releases
Hacer rollback de la aplicación a una release
Devuelve la aplicación a una release anterior, restaurando su código, eliminando los archivos que no tenía y reiniciándola, con variables opcionales.
POST
/
v1
/
apps
/
{id}
/
releases
/
{release_id}
/
rollback
Hacer rollback de la aplicación a una release
curl --request POST \
--url https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"restore_environment": true
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({restore_environment: true})
};
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"
payload = { "restore_environment": True }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/releases/{release_id}/rollback"
payload := strings.NewReader("{\n \"restore_environment\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"id": "5b8e3f10-2c4a-4d9b-a7e1-0f3c6b9d2e54",
"app_id": "7a52e0d4-19b3-4f8e-b6c2-0d9e4a1f5c73",
"source": "rollback",
"status": "active",
"message": null,
"author": "octocat",
"github": null,
"files_changed": 4,
"rollback": {
"available": false,
"expires_at": null,
"from": "3f1c2a9e-8b7d-4c21-9e0a-5d6f7a8b9c01"
},
"has_log": false,
"build_duration_ms": 12450,
"first_started_at": "2026-10-11T15:02:50.000Z",
"created_at": "2026-10-11T15:02:37.000Z"
}
}
Devuelve la aplicación al código que tenía en esta release, y después la reinicia. El rollback se registra como una nueva release con
Lo que hace el rollback:
source: "rollback", así que puedes deshacerlo de la misma forma. Opcionalmente, también restaura las variables de entorno guardadas con esa release.
Un rollback no toca los datos que la aplicación creó mientras se ejecutaba, como un archivo de base de datos o las subidas. Para recuperar esos datos, usa un snapshot.
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 hacer rollback, tal como lo devuelve la lista de releases. Debe ser una release cuyo código siga conservándose (
rollback.available es true).string
Si la aplicación pertenece a un workspace, el ID del workspace.
boolean
predeterminado:"false"
Opcional.
true también reemplaza las variables de entorno de la aplicación por las guardadas con esa release. El valor predeterminado false mantiene las variables que la aplicación tiene ahora. Revisa antes los cambios con la previsualización del rollback.- Código: cada archivo de código de la release se restaura exactamente como estaba. Los archivos de código que la release no tenía se eliminan.
- Datos: los archivos que la aplicación creó mientras se ejecutaba no se modifican ni se eliminan.
- Variables: no cambian, salvo que
restore_environmentseatrue. - Reinicio: la aplicación se reinicia con un build forzado, así que su comando de build se vuelve a ejecutar si tiene uno.
- Historial de releases: la versión que estaba en ejecución pasa a
rolled_back, y la nueva release pasa a ser la activa. Surollback.fromes la release que restauraste.
- Un rollback no usa los slots de despliegue de tu plan, pero dos rollbacks de la misma aplicación necesitan al menos 30 segundos entre sí. Los rollbacks también tienen su propio límite por hora y cuenta, igual al límite de despliegues por hora de tu plan. Si lo superas, se devuelve
429 DEPLOY_RATE_LIMITED, condetails.limit,details.window_secondsydetails.retry_after, y no consume ningún slot de despliegue. - Si el código de la release no se puede restaurar, la petición falla con
INTERNAL_SERVER_ERROR. No cambia nada. Si el código guardado de esa release está dañado, falla conINVALID_ZIP_STRUCTURE(400) antes de tocar ningún archivo. - Si el reinicio falla después de restaurar los archivos, la respuesta es el error del reinicio (por ejemplo,
BUILD_FAILED). La aplicación ya ejecuta el código restaurado, así que corrige la causa y reinícala.
apps:write cuando se llama con una clave de API. Si restore_environment es true, la clave también necesita el scope apps:envs; sin él, la petición devuelve 403 API_KEY_SCOPE_DENIED. Para un miembro de un workspace, requiere los permisos apps:files y apps:lifecycle, además de apps:envs si se restauran variables.
Respuesta
object
La nueva release creada por el rollback.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID de la nueva release.
string
Siempre
rollback en esta respuesta.string
active, la versión que la aplicación ejecuta ahora.object
string | null
El mensaje de la release.
null cuando no se indicó ninguno.integer
Número de archivos modificados por la operación que produjo esta release.
integer | null
Tiempo, en milisegundos, invertido en hacer el build y arrancar la aplicación.
string | null
Cuándo arrancó por primera vez la aplicación con el código de esta release, es decir, cuándo terminó el reinicio del rollback.
string
Marca de tiempo ISO de cuándo se hizo el rollback.
string
El nombre del usuario que hizo el rollback.
string
El ID de la aplicación.
null
null, porque un rollback no es un push de GitHub.boolean
true cuando se registró un log de fallo para esta release.{
"response": {
"id": "5b8e3f10-2c4a-4d9b-a7e1-0f3c6b9d2e54",
"app_id": "7a52e0d4-19b3-4f8e-b6c2-0d9e4a1f5c73",
"source": "rollback",
"status": "active",
"message": null,
"author": "octocat",
"github": null,
"files_changed": 4,
"rollback": {
"available": false,
"expires_at": null,
"from": "3f1c2a9e-8b7d-4c21-9e0a-5d6f7a8b9c01"
},
"has_log": false,
"build_duration_ms": 12450,
"first_started_at": "2026-10-11T15:02:50.000Z",
"created_at": "2026-10-11T15:02:37.000Z"
}
}
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:write, o le faltaapps:envsmientrasrestore_environmentestrue(403).RELEASE_ALREADY_ACTIVE: La release ya es la que ejecuta la aplicación, o tiene el mismo código yrestore_environmentno cambiaría nada (409).RELEASE_EXPIRED: El código de esta release ya no se conserva, porque expiró o es más antigua que el número de releases que tu plan conserva (410).OPERATION_IN_PROGRESS: Otra operación de ciclo de vida sobre la misma aplicación ya está en curso (409). No se cambió nada; espera unos segundos y vuelve a intentarlo.RESTORE_COOLDOWN: El rollback anterior de esta aplicación fue hace menos de 30 segundos (429). Espera y vuelve a intentarlo.DEPLOY_RATE_LIMITED: Se alcanzó el límite horario de rollbacks de la cuenta (429).detailsincluyelimit,window_secondsyretry_after. Espera y vuelve a intentarlo.
string
Un mensaje descriptivo con más detalles sobre el error.
{
"code": "RELEASE_EXPIRED"
}
{
"code": "RESTORE_COOLDOWN"
}
Última modificación el 28 de octubre de 2026