List Image Versions
curl --request GET \
--url https://api.vertracloud.app/v1/images/{image_id}/versionsimport requests
url = "https://api.vertracloud.app/v1/images/{image_id}/versions"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
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));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vertracloud.app/v1/images/{image_id}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}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)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.vertracloud.app/v1/images/{image_id}/versions")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/images/{image_id}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"response": [
{
"id": "imgv-111aaa222bbb",
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"source": "upload",
"message": "first build",
"created_at": "2026-10-23T14:09:00Z",
"in_use": true
}
]
}
Docker Images
List Image Versions
Lists the versions of an image, newest first. Each successful build is a new version of the same image.
GET
/
v1
/
images
/
{image_id}
/
versions
List Image Versions
curl --request GET \
--url https://api.vertracloud.app/v1/images/{image_id}/versionsimport requests
url = "https://api.vertracloud.app/v1/images/{image_id}/versions"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
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));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vertracloud.app/v1/images/{image_id}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}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)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.vertracloud.app/v1/images/{image_id}/versions")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/images/{image_id}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"response": [
{
"id": "imgv-111aaa222bbb",
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"source": "upload",
"message": "first build",
"created_at": "2026-10-23T14:09:00Z",
"in_use": true
}
]
}
Needs the
images:read scope when called with an API key.
string
required
The image ID.
string
If the image belongs to a workspace, the workspace’s ID. Required for workspace members acting on an image they don’t own.
Response
array
An array of versions, newest first.
Show Toggle object
Show Toggle object
string
The version ID. Use it as
version_id to read the build log of that version.string
Digest (
sha256:...) of the version.string
What triggered the build:
upload (a full context uploaded), commit (files committed on top of the current context) or github (a push to the linked branch).string | null
The message sent with the upload or commit, or
null.string
When the version was built.
boolean
true when at least one application runs this version.{
"response": [
{
"id": "imgv-111aaa222bbb",
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"source": "upload",
"message": "first build",
"created_at": "2026-10-23T14:09:00Z",
"in_use": true
}
]
}
An application keeps up to 30 releases for 30 days on the Enterprise plans, and each release points to one image version. Roll back an application with Rollback Application. A version is only removed when no release of any app uses it and it is not the current one.
Error Responses
string
The error code indicating the reason for the failure. Possible values:
API_KEY_SCOPE_DENIED: The API key does not have the required scope (403).IMAGE_NOT_FOUND: The image does not exist or you cannot access it (404).INTERNAL_SERVER_ERROR: Unexpected failure (500).
{
"code": "IMAGE_NOT_FOUND"
}