Listar versiones de la imagen
curl --request GET \
--url https://api.vertracloud.app/v1/images/{image_id}/versions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/images/{image_id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/images/{image_id}/versions"
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/{image_id}/versions"
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": "imgv-111aaa222bbb",
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"source": "upload",
"message": "first build",
"created_at": "2026-10-23T14:09:00Z",
"in_use": true
}
]
}
Imágenes Docker
Listar versiones de la imagen
Lista las versiones de una imagen, de la más reciente a la más antigua. Cada build exitoso es una nueva versión de la misma imagen.
GET
/
v1
/
images
/
{image_id}
/
versions
Listar versiones de la imagen
curl --request GET \
--url https://api.vertracloud.app/v1/images/{image_id}/versions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/images/{image_id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/images/{image_id}/versions"
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/{image_id}/versions"
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": "imgv-111aaa222bbb",
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"source": "upload",
"message": "first build",
"created_at": "2026-10-23T14:09:00Z",
"in_use": true
}
]
}
Requiere el scope
images:read cuando se llama con una clave de API.
string
requerido
El ID de la imagen.
string
Si la imagen pertenece a un workspace, el ID del workspace. Es obligatorio para los miembros del workspace que actúen sobre una imagen que no les pertenece.
Response
array
Un array de versiones, de la más reciente a la más antigua.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID de la versión. Úsalo como
version_id para leer el log de build de esa versión.string
Digest (
sha256:...) de la versión.string
Lo que disparó el build:
upload (se subió un contexto completo), commit (archivos confirmados sobre el contexto actual) o github (un push a la rama vinculada).string | null
El mensaje enviado con la subida o el commit, o
null.string
Cuándo se construyó la versión.
boolean
true cuando al menos una aplicación ejecuta esta versión.{
"response": [
{
"id": "imgv-111aaa222bbb",
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"source": "upload",
"message": "first build",
"created_at": "2026-10-23T14:09:00Z",
"in_use": true
}
]
}
Una aplicación conserva hasta 30 releases durante 30 días en los planes Enterprise, y cada release apunta a una versión de la imagen. Para volver atrás una aplicación, usa Revertir aplicación. Una versión solo se elimina cuando ningún release de ninguna aplicación la usa y no es la actual.
Error Responses
string
El código de error que indica el motivo del fallo. Valores posibles:
API_KEY_SCOPE_DENIED: La clave de API no tiene el scope necesario (403).IMAGE_NOT_FOUND: La imagen no existe o no puedes acceder a ella (404).INTERNAL_SERVER_ERROR: Fallo inesperado (500).
{
"code": "IMAGE_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026