Unlink Image from GitHub
curl --request DELETE \
--url https://api.vertracloud.app/v1/images/{image_id}/githubimport requests
url = "https://api.vertracloud.app/v1/images/{image_id}/github"
response = requests.delete(url)
print(response.text)const options = {method: 'DELETE'};
fetch('https://api.vertracloud.app/v1/images/{image_id}/github', 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}/github",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
]);
$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}/github"
req, _ := http.NewRequest("DELETE", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.vertracloud.app/v1/images/{image_id}/github")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/images/{image_id}/github")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
response = http.request(request)
puts response.read_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,
"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"
}
}
Docker Images
Unlink Image from GitHub
Removes the link between an image and its GitHub repository.
DELETE
/
v1
/
images
/
{image_id}
/
github
Unlink Image from GitHub
curl --request DELETE \
--url https://api.vertracloud.app/v1/images/{image_id}/githubimport requests
url = "https://api.vertracloud.app/v1/images/{image_id}/github"
response = requests.delete(url)
print(response.text)const options = {method: 'DELETE'};
fetch('https://api.vertracloud.app/v1/images/{image_id}/github', 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}/github",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
]);
$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}/github"
req, _ := http.NewRequest("DELETE", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.vertracloud.app/v1/images/{image_id}/github")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/images/{image_id}/github")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
response = http.request(request)
puts response.read_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,
"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"
}
}
After unlinking, pushes no longer rebuild the image. Existing versions and applications are not affected. You can link again at any time with Link Image to GitHub. Only the image’s owner can unlink it; in a workspace, a member gets
403.
Needs the images:write scope when called with an API key.
string
required
The image ID.
string
If the image belongs to a workspace, the workspace’s ID.
Response
object
The image.
Show Toggle object
Show Toggle object
string
The image ID.
string
The image name.
string | null
The image description (free text, up to 128 characters), or
null when it has none.string
account for your own images, system for images provided by the platform (these cannot be changed or deleted).string
State of the latest build:
building, success or failed. A failed rebuild does not change the current version: apps keep running the last good one.string | null
Readable reason of the latest failed build, or
null.string | null
Digest (
sha256:...) of the current version, or null while no build has succeeded.integer | null
Size of the current version, uncompressed, in bytes.
integer | null
Number of layers of the current version.
object[]
The applications created from this image. Each has
id, name, version_id (the image version it runs, or null) and outdated (true when the image has a newer version; the app moves to it on the next restart or deploy you ask for).object | null
The linked GitHub repository and branch (
repository as owner/name, branch), or null when the image is not linked.string | null
The current version of the image, or
null while no build has succeeded.string
When the image was created.
string
When the image was last updated.
{
"response": {
"id": "img-abc123def456",
"name": "my-api",
"description": null,
"owner": "account",
"status": "success",
"error": null,
"digest": "sha256:3f1c0a9d5b7e2c4a8d6f1b0e9c3a7d5f2b4e6a8c0d1f3b5a7c9e2d4f6a8b0c1e",
"uncompressed_bytes": 187432960,
"layer_count": 9,
"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
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).ACCESS_DENIED: You are not the owner of the image, or it is a platform image (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"
}