Listar imágenes
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"
}
]
}
Imágenes Docker
Listar imágenes
Lista las imágenes Docker personalizadas de la cuenta.
GET
/
v1
/
images
Listar imágenes
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"
}
]
}
Requiere el scope
images:read cuando se llama con una clave de API.
string
Lista las imágenes de ese workspace en lugar de las propias de la cuenta.
Response
array
Un array de imágenes.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID de la imagen.
string
El nombre de la imagen.
string | null
La descripción de la imagen (texto libre, de hasta 128 caracteres), o
null si no tiene ninguna.string
account para tus imágenes, system para las imágenes que proporciona la plataforma (estas no se pueden modificar ni eliminar).string
own para una imagen que construiste tú, o template_copy para la copia de la imagen de una plantilla que usar una plantilla dejó en tu cuenta. Una copia ocupa un hueco de imagen y solo se puede usar a través de su plantilla.object | null
En el caso de un
template_copy, la plantilla de la que procede: template_id, template_name (por idioma) y author_display (null para una plantilla de la plataforma). null para tus propias imágenes.string
Estado del último build:
building, success o failed. Una reconstrucción fallida no cambia la versión actual: las aplicaciones siguen ejecutando la última que funcionó.string | null
Motivo legible del último build fallido, o
null.string | null
Digest (
sha256:...) de la versión actual, o null mientras ningún build haya tenido éxito.integer | null
Tamaño de la versión actual, sin comprimir, en bytes.
integer | null
Número de capas de la versión actual.
integer | null
Puerto sugerido para una aplicación nueva sobre esta imagen: el primer
EXPOSE del Dockerfile del contexto de build más reciente, o 80. null en el caso de una imagen creada antes de que existiera este campo.object[]
Las aplicaciones creadas a partir de esta imagen. Cada una tiene
id, name, version_id (la versión de la imagen que ejecuta, o null) y outdated (true cuando la imagen tiene una versión más nueva; la aplicación pasa a ella en el siguiente reinicio o despliegue que pidas).object | null
El repositorio y la rama de GitHub vinculados (
repository como owner/name, branch), o null si la imagen no está vinculada.string | null
La versión actual de la imagen, o
null mientras ningún build haya tenido éxito.string
Cuándo se creó la imagen.
string
Cuándo se actualizó por última vez la imagen.
{
"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"
}
]
}
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).INTERNAL_SERVER_ERROR: Fallo inesperado (500).
{
"code": "API_KEY_SCOPE_DENIED"
}
Última modificación el 28 de octubre de 2026