Listar releases da aplicação

curl --request GET \
  --url https://api.vertracloud.app/v1/apps/{id}/releases \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vertracloud.app/v1/apps/{id}/releases', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vertracloud.app/v1/apps/{id}/releases"

	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": {
    "data": [
      {
        "id": "3f1c2a9e-8b7d-4c21-9e0a-5d6f7a8b9c01",
        "app_id": "7a52e0d4-19b3-4f8e-b6c2-0d9e4a1f5c73",
        "source": "github",
        "status": "active",
        "message": "Fix checkout total",
        "author": "octocat",
        "github": {
          "app_id": "7a52e0d4-19b3-4f8e-b6c2-0d9e4a1f5c73",
          "commit_id": "a3f9c1e7b2d4568f0e1c9a7b3d5f2e8c4a6b1d90",
          "message": "Fix checkout total",
          "pusher": "octocat",
          "branch": "main",
          "created_at": "2026-10-10T14:22:05.000Z"
        },
        "files_changed": 3,
        "rollback": {
          "available": false,
          "expires_at": null,
          "from": null
        },
        "has_log": false,
        "build_duration_ms": 48210,
        "first_started_at": "2026-10-10T14:22:53.000Z",
        "created_at": "2026-10-10T14:22:05.000Z"
      }
    ],
    "total_count": 1,
    "page": 1,
    "limit": 20,
    "total_pages": 1,
    "has_next_page": false,
    "has_previous_page": false
  }
}

GET

apps

{id}

releases

Listar releases da aplicação

curl --request GET \
  --url https://api.vertracloud.app/v1/apps/{id}/releases \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vertracloud.app/v1/apps/{id}/releases', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vertracloud.app/v1/apps/{id}/releases"

	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": {
    "data": [
      {
        "id": "3f1c2a9e-8b7d-4c21-9e0a-5d6f7a8b9c01",
        "app_id": "7a52e0d4-19b3-4f8e-b6c2-0d9e4a1f5c73",
        "source": "github",
        "status": "active",
        "message": "Fix checkout total",
        "author": "octocat",
        "github": {
          "app_id": "7a52e0d4-19b3-4f8e-b6c2-0d9e4a1f5c73",
          "commit_id": "a3f9c1e7b2d4568f0e1c9a7b3d5f2e8c4a6b1d90",
          "message": "Fix checkout total",
          "pusher": "octocat",
          "branch": "main",
          "created_at": "2026-10-10T14:22:05.000Z"
        },
        "files_changed": 3,
        "rollback": {
          "available": false,
          "expires_at": null,
          "from": null
        },
        "has_log": false,
        "build_duration_ms": 48210,
        "first_started_at": "2026-10-10T14:22:53.000Z",
        "created_at": "2026-10-10T14:22:05.000Z"
      }
    ],
    "total_count": 1,
    "page": 1,
    "limit": 20,
    "total_pages": 1,
    "has_next_page": false,
    "has_previous_page": false
  }
}

Retorna o histórico de releases de uma aplicação: uma entrada para cada versão do seu código, da mais recente para a mais antiga. Cada entrada informa como a versão foi criada, se é a que está rodando agora e se ela pode ser restaurada.

O histórico começa na primeira submissão de código feita depois do lançamento deste recurso. Releases criadas a partir de um snapshot não aparecem nele.

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.

integer

padrão:"1"

Número da página, começando em 1.

integer

padrão:"20"

Releases por página. Máximo 50; valores maiores retornam 400 VALIDATION_ERROR.

string

Se a aplicação pertencer a um workspace, o ID do workspace.

Exige o escopo apps:read quando chamado com uma chave de API.

Resposta

object

Lista paginada, da mais recente para a mais antiga.

Mostrar Mostrar objeto

APIApplicationRelease[]

Mostrar Mostrar objeto

string

O ID da release. Passe-o para o endpoint de log da release.

string

O ID da aplicação.

string

Como a release foi criada: github (push para o repositório conectado), cli (a CLI da Vertra), upload (upload pelo painel, por um SDK ou por uma extensão), editor (edição feita no gerenciador de arquivos), rollback (restaura uma release anterior) ou env_change (variáveis de ambiente alteradas, sem mudança de código).

string

Em que ponto do ciclo de vida a release está: deploying (sendo buildada e iniciada), active (a versão que a aplicação roda agora; há apenas uma), superseded (substituída por uma release mais nova), failed (o deploy não iniciou), rolled_back (substituída por um rollback) ou expired (o código dela não é mais mantido).

string | null

A mensagem do commit ou do upload. null quando nenhuma foi informada, e sempre null para edições do gerenciador de arquivos.

string

O usuário do GitHub que fez o push, ou o nome do usuário que enviou ou editou os arquivos.

object | null

O push do GitHub que originou esta release, com app_id, commit_id, message, pusher, branch e created_at. null para qualquer outra origem.

integer

Número de arquivos alterados pela operação que gerou esta release.

object

Informações de restauração desta release.

Mostrar Mostrar objeto

boolean

true quando você pode fazer rollback da aplicação para esta release. É false para a release ativa, para uma release expirada e quando o seu plano não permite fazer rollback para ela.

string | null

Quando o código desta release deixa de ser mantido, contado a partir do momento em que ela deixou de ser a release ativa. null para a release ativa e quando nenhum código foi mantido.

string | null

A release que esta restaura, quando source é rollback. null nos demais casos.

boolean

true quando um log de crash foi registrado para esta release. O log ainda pode expirar; veja o endpoint de log da release.

integer | null

Tempo, em milissegundos, gasto na instalação das dependências, no build e na inicialização desta release. null quando ela não foi deployada com build, por exemplo arquivos commitados sem um restart.

string | null

Quando a aplicação iniciou pela primeira vez com o código desta release. null enquanto o código está na pasta da aplicação, mas ela ainda não foi reiniciada com ele: as mudanças só valem após um restart.

string

Timestamp ISO de quando a release foi criada.

integer

Total de releases no histórico.

integer

Página atual.

integer

Releases por página.

integer

Total de páginas.

boolean

{
  "response": {
    "data": [
      {
        "id": "3f1c2a9e-8b7d-4c21-9e0a-5d6f7a8b9c01",
        "app_id": "7a52e0d4-19b3-4f8e-b6c2-0d9e4a1f5c73",
        "source": "github",
        "status": "active",
        "message": "Fix checkout total",
        "author": "octocat",
        "github": {
          "app_id": "7a52e0d4-19b3-4f8e-b6c2-0d9e4a1f5c73",
          "commit_id": "a3f9c1e7b2d4568f0e1c9a7b3d5f2e8c4a6b1d90",
          "message": "Fix checkout total",
          "pusher": "octocat",
          "branch": "main",
          "created_at": "2026-10-10T14:22:05.000Z"
        },
        "files_changed": 3,
        "rollback": {
          "available": false,
          "expires_at": null,
          "from": null
        },
        "has_log": false,
        "build_duration_ms": 48210,
        "first_started_at": "2026-10-10T14:22:53.000Z",
        "created_at": "2026-10-10T14:22:05.000Z"
      }
    ],
    "total_count": 1,
    "page": 1,
    "limit": 20,
    "total_pages": 1,
    "has_next_page": false,
    "has_previous_page": false
  }
}

Respostas de erro

string

Códigos de erro possíveis:

AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: o header Authorization está ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).
API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: a chave de API é usada a partir de um IP fora da sua allowlist, ou não tem o escopo que a rota exige (403).
APP_NOT_FOUND: a aplicação não existe, ou não pertence a esta conta ou workspace (404).
VALIDATION_ERROR: o page ou o limit é inválido, por exemplo um limit acima de 50 (400).

string

Uma mensagem descritiva com detalhes adicionais sobre o erro.

{
  "code": "APP_NOT_FOUND"
}

As entradas desta lista são mantidas permanentemente. O código das releases mais antigas, porém, é mantido apenas por um período que depende do seu plano, e esse período começa quando a release deixa de ser a ativa, não quando foi criada. Depois que o código expira, a entrada mostra status: "expired" e rollback.available: false.

Última modificação em 28 de outubro de 2026

Visão geral

Endpoints

Listar releases da aplicação

Resposta

Respostas de erro

​Resposta

​Respostas de erro

Resposta

Respostas de erro