Listar imagens
curl --request GET \
--url https://api.vertracloud.app/v1/images \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/images', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/images"
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/images"
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": [
{
"id": "img-abc123def456",
"name": "my-api",
"description": null,
"owner": "account",
"status": "success",
"error": null,
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"uncompressed_bytes": 187432960,
"layer_count": 9,
"suggested_port": 3000,
"apps": [
{
"id": "app-abc123def456",
"name": "my-api-prod",
"version_id": "imgv-111aaa222bbb",
"outdated": false
}
],
"github": null,
"current_version_id": "imgv-111aaa222bbb",
"created_at": "2026-10-23T14:02:00Z",
"updated_at": "2026-10-23T14:09:00Z"
}
]
}
Imagens Docker
Listar imagens
Lista as imagens Docker personalizadas da conta.
GET
/
v1
/
images
Listar imagens
curl --request GET \
--url https://api.vertracloud.app/v1/images \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/images', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/images"
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/images"
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": [
{
"id": "img-abc123def456",
"name": "my-api",
"description": null,
"owner": "account",
"status": "success",
"error": null,
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"uncompressed_bytes": 187432960,
"layer_count": 9,
"suggested_port": 3000,
"apps": [
{
"id": "app-abc123def456",
"name": "my-api-prod",
"version_id": "imgv-111aaa222bbb",
"outdated": false
}
],
"github": null,
"current_version_id": "imgv-111aaa222bbb",
"created_at": "2026-10-23T14:02:00Z",
"updated_at": "2026-10-23T14:09:00Z"
}
]
}
Precisa do escopo
images:read quando chamado com uma chave de API.
string
Lista as imagens desse workspace em vez das imagens da conta.
Resposta
array
Um array de imagens.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
O ID da imagem.
string
O nome da imagem.
string | null
A descrição da imagem (texto livre, até 128 caracteres), ou
null quando ela não tem uma.string
account para as suas imagens, system para imagens fornecidas pela plataforma (estas não podem ser alteradas nem apagadas).string
own para uma imagem que você construiu, ou template_copy para a cópia da imagem de um template que usar um template colocou na sua conta. Uma cópia ocupa uma vaga de imagem e só pode ser usada pelo template dela.object | null
Para um
template_copy, o template de onde ela veio: template_id, template_name (por idioma) e author_display (null para um template da plataforma). null para as suas imagens.string
Estado do build mais recente:
building, success ou failed. Uma reconstrução que falha não muda a versão atual: os apps continuam rodando a última versão que deu certo.string | null
Motivo legível do último build que falhou, ou
null.string | null
Digest (
sha256:...) da versão atual, ou null enquanto nenhum build tiver dado certo.integer | null
Tamanho da versão atual, descompactada, em bytes.
integer | null
Número de camadas da versão atual.
integer | null
Porta sugerida para um novo app nesta imagem: o primeiro
EXPOSE do Dockerfile do contexto de build mais recente, ou 80. null para uma imagem criada antes deste campo existir.object[]
Os apps criados a partir desta imagem. Cada um tem
id, name, version_id (a versão da imagem que ele executa, ou null) e outdated (true quando a imagem tem uma versão mais nova; o app passa para ela no próximo restart ou deploy que você pedir).object | null
O repositório e a branch do GitHub vinculados (
repository no formato owner/name, branch), ou null quando a imagem não está vinculada.string | null
A versão atual da imagem, ou
null enquanto nenhum build tiver dado certo.string
Quando a imagem foi criada.
string
Quando a imagem foi atualizada pela última vez.
{
"response": [
{
"id": "img-abc123def456",
"name": "my-api",
"description": null,
"owner": "account",
"status": "success",
"error": null,
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"uncompressed_bytes": 187432960,
"layer_count": 9,
"suggested_port": 3000,
"apps": [
{
"id": "app-abc123def456",
"name": "my-api-prod",
"version_id": "imgv-111aaa222bbb",
"outdated": false
}
],
"github": null,
"current_version_id": "imgv-111aaa222bbb",
"created_at": "2026-10-23T14:02:00Z",
"updated_at": "2026-10-23T14:09:00Z"
}
]
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
API_KEY_SCOPE_DENIED: A chave de API não tem o escopo necessário (403).INTERNAL_SERVER_ERROR: Falha inesperada (500).
{
"code": "API_KEY_SCOPE_DENIED"
}
Última modificação em 28 de outubro de 2026