Pré-visualizar rollback da aplicação
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
Pré-visualizar rollback da aplicação
Pré-visualiza as variáveis de ambiente que um rollback para esta release adicionaria, alteraria ou removeria, só com nomes e tipos de mudança.
GET
/
v1
/
apps
/
{id}
/
releases
/
{release_id}
/
rollback
Pré-visualizar rollback da aplicação
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": []
}
}
Retorna quais variáveis de ambiente mudariam se você fizesse o rollback da aplicação para esta release e restaurasse as variáveis dela. Só voltam os nomes das variáveis e o tipo de mudança, nunca os valores. Nada é alterado.
O rollback não restaura variáveis a menos que você peça. Confira esta pré-visualização primeiro e então envie a requisição de rollback com
Cada mudança é comparada com as variáveis atuais da aplicação, incluindo as salvas mas ainda não aplicadas por um restart. Essas são as variáveis que um rollback sobrescreve:
restore_environment: true se as mudanças forem as que você quer.
string
obrigatório
O ID da aplicação. Se a aplicação pertencer a um workspace, informe o ID dele no query parameter
workspace_id.string
obrigatório
O ID da release para a qual você faria o rollback, como retornado pela lista de releases.
string
Se a aplicação pertencer a um workspace, o ID do workspace.
added: a release tem a variável, e as variáveis atuais não têm.removed: as variáveis atuais têm a variável, e a release não tem. Uma variável criada depois da release e ainda não aplicada por um restart aparece comoremoved.modified: ambas têm a variável, com valores diferentes.
apps:envs quando chamado com uma chave de API. Para um membro do workspace, exige a permissão apps:envs.
Resposta
object
{
"response": {
"environment_changes": [
{ "key": "DISCORD_TOKEN", "change": "modified" },
{ "key": "NEW_FEATURE", "change": "removed" }
]
}
}
{
"response": {
"environment_changes": []
}
}
Respostas de erro
string
Códigos de erro possíveis:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: o headerAuthorizationestá ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).API_KEY_IP_DENIED: a chave de API é usada a partir de um IP fora da sua allowlist (403).APP_NOT_FOUND: a aplicação não existe, ou não pertence a esta conta ou workspace (404).RELEASE_NOT_FOUND: a release não existe, ou pertence a outra aplicação (404).PLAN_DOES_NOT_SUPPORT_ROLLBACK: o seu plano não inclui fazer rollback para releases anteriores (403). O rollback começa no Pro.API_KEY_SCOPE_DENIED: a chave de API não tem o escopoapps:envs(403).
string
Uma mensagem descritiva com detalhes adicionais sobre o erro.
{
"code": "RELEASE_NOT_FOUND"
}
Uma release guarda as variáveis com as quais a aplicação foi iniciada. Releases criadas antes do lançamento deste recurso não têm nenhuma salva, então a pré-visualização delas é sempre vazia.
Última modificação em 28 de outubro de 2026