Desvincular imagem do GitHub
curl --request DELETE \
--url https://api.vertracloud.app/v1/images/{image_id}/github \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
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));import requests
url = "https://api.vertracloud.app/v1/images/{image_id}/github"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)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)
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,
"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
Desvincular imagem do GitHub
Remove o vínculo entre uma imagem e o repositório dela no GitHub.
DELETE
/
v1
/
images
/
{image_id}
/
github
Desvincular imagem do GitHub
curl --request DELETE \
--url https://api.vertracloud.app/v1/images/{image_id}/github \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
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));import requests
url = "https://api.vertracloud.app/v1/images/{image_id}/github"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)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)
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,
"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"
}
}
Depois de desvincular, pushes não reconstroem mais a imagem. Versões e apps existentes não são afetados. Você pode vincular de novo a qualquer momento com Vincular imagem ao GitHub. Só o dono da imagem pode desvinculá-la; em um workspace, um membro recebe
403.
Precisa do escopo images:write quando chamado com uma chave de API.
string
obrigatório
O ID da imagem.
string
Se a imagem pertencer a um workspace, o ID do workspace.
Resposta
object
A imagem.
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
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.
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,
"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).ACCESS_DENIED: Você não é o dono da imagem, ou ela é uma imagem da plataforma (403).IMAGE_NOT_FOUND: A imagem não existe ou você não tem acesso a ela (404).INTERNAL_SERVER_ERROR: Falha inesperada (500).
{
"code": "IMAGE_NOT_FOUND"
}
Última modificação em 28 de outubro de 2026