Desvincular imagen de 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"
}
}
Imágenes Docker
Desvincular imagen de GitHub
Elimina el vínculo entre una imagen y su repositorio de GitHub.
DELETE
/
v1
/
images
/
{image_id}
/
github
Desvincular imagen de 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"
}
}
Tras desvincular, los pushes ya no reconstruyen la imagen. Las versiones y las aplicaciones existentes no se ven afectadas. Puedes volver a vincularla en cualquier momento con Vincular imagen a GitHub. Solo el propietario de la imagen puede desvincularla; en un workspace, un miembro recibe
403.
Requiere el scope images:write 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.
Response
object
La imagen.
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
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.
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,
"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).ACCESS_DENIED: No eres el propietario de la imagen, o es una imagen de la plataforma (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