Obtener stack
curl --request GET \
--url https://api.vertracloud.app/v1/stacks/{stack_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/stacks/{stack_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/stacks/{stack_id}"
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/stacks/{stack_id}"
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": "stk-abc123def456",
"name": "shop",
"description": null,
"network_mode": "public",
"owner_id": "usr-abc123",
"workspace_id": null,
"members": [
{ "resource_type": "application", "resource_id": "app-abc123def456", "name": "web", "status": "up", "ram": 512, "service_key": null, "database_type": null, "closed": false, "blob": null },
{ "resource_type": "database", "resource_id": "db-abc123def456", "name": "main", "status": "up", "ram": 256, "service_key": null, "database_type": "postgres", "closed": false, "blob": null }
],
"status": { "up": 2, "down": 0, "building": 0, "total": 2 },
"ram_total": 768,
"bindings": [
{
"id": "bnd-abc123def456",
"stack_id": "stk-abc123def456",
"app_id": "app-abc123def456",
"database_id": "db-abc123def456",
"blob_id": null,
"target_app_id": null,
"env_map": { "DATABASE_URL": "url" },
"certs_path": "/app/.vertra/certs/db-abc123def456/",
"created_at": "2026-10-27T12:00:00.000Z"
}
],
"template": null,
"update_available": false,
"created_at": "2026-10-27T12:00:00.000Z",
"updated_at": "2026-10-27T12:00:00.000Z"
}
}
Stacks
Obtener stack
Devuelve un stack con sus miembros, estado, conexiones, memoria total y la plantilla de la que procede.
GET
/
v1
/
stacks
/
{stack_id}
Obtener stack
curl --request GET \
--url https://api.vertracloud.app/v1/stacks/{stack_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/stacks/{stack_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/stacks/{stack_id}"
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/stacks/{stack_id}"
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": "stk-abc123def456",
"name": "shop",
"description": null,
"network_mode": "public",
"owner_id": "usr-abc123",
"workspace_id": null,
"members": [
{ "resource_type": "application", "resource_id": "app-abc123def456", "name": "web", "status": "up", "ram": 512, "service_key": null, "database_type": null, "closed": false, "blob": null },
{ "resource_type": "database", "resource_id": "db-abc123def456", "name": "main", "status": "up", "ram": 256, "service_key": null, "database_type": "postgres", "closed": false, "blob": null }
],
"status": { "up": 2, "down": 0, "building": 0, "total": 2 },
"ram_total": 768,
"bindings": [
{
"id": "bnd-abc123def456",
"stack_id": "stk-abc123def456",
"app_id": "app-abc123def456",
"database_id": "db-abc123def456",
"blob_id": null,
"target_app_id": null,
"env_map": { "DATABASE_URL": "url" },
"certs_path": "/app/.vertra/certs/db-abc123def456/",
"created_at": "2026-10-27T12:00:00.000Z"
}
],
"template": null,
"update_available": false,
"created_at": "2026-10-27T12:00:00.000Z",
"updated_at": "2026-10-27T12:00:00.000Z"
}
}
Devuelve un stack y todo lo que contiene: aplicaciones, bases de datos y carpetas de Blob, las conexiones entre ellas, el estado de los miembros sumado y, cuando el stack procede de una plantilla, la plantilla y su versión. Requiere el scope
stacks:read cuando se llama con una clave de API.
string
requerido
El ID del stack.
string
El workspace al que pertenece el stack. Es obligatorio para un miembro del workspace que actúe sobre un stack que no le pertenece; el propietario puede omitirlo.
Response
object
El stack.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID del stack.
string
El nombre del stack.
string | null
Descripción opcional, o
null.string
Cómo se comunican entre sí los miembros. El valor es
public: los servicios usan sus direcciones públicas y las bases de datos se alcanzan con certificados de cliente.string
La cuenta que es propietaria del stack.
string | null
El workspace al que pertenece el stack, o
null cuando es tuyo.object[]
Los miembros. Cada uno tiene
resource_type (application, database o blob), resource_id, name, status (null para una carpeta de Blob), ram en MB (0 para una carpeta de Blob), service_key (el ID del servicio en la plantilla, null para un miembro que añadiste tú), database_type (el motor de una base de datos, si no null), closed (true para una aplicación de una plantilla cerrada: su código no es accesible) y blob.Para un miembro Blob, blob tiene el prefix de la carpeta, visibility (private o public), used_bytes (o null) y api_key_id, la clave que creó la plataforma para el stack y restringida a esa carpeta. Consulta Añadir carpeta de Blob.object
Miembros en línea, fuera de línea y en build, sumados:
up, down, building y total (los miembros que tienen estado).integer
Memoria de todos los miembros, en MB.
object[]
Las conexiones entre miembros. Cada una tiene
id, stack_id, app_id (la aplicación que recibe las variables), exactamente uno de database_id, blob_id y target_app_id, env_map (nombre de variable y lo que recibe), certs_path (la carpeta dentro de la aplicación donde se escriben los certificados de cliente de una base de datos, null sin base de datos) y created_at. Consulta Crear conexión.object | null
La plantilla y la versión de las que procede el stack, o
null para un stack montado a mano. Tiene los mismos campos que el template de una aplicación, incluido icon_url, la URL estable del icono de la plantilla (null cuando no hay ninguno).boolean
true cuando la plantilla tiene una versión más nueva a la que el stack puede actualizarse.string
Cuándo se creó el stack.
string
Cuándo se actualizó por última vez el stack.
{
"response": {
"id": "stk-abc123def456",
"name": "shop",
"description": null,
"network_mode": "public",
"owner_id": "usr-abc123",
"workspace_id": null,
"members": [
{ "resource_type": "application", "resource_id": "app-abc123def456", "name": "web", "status": "up", "ram": 512, "service_key": null, "database_type": null, "closed": false, "blob": null },
{ "resource_type": "database", "resource_id": "db-abc123def456", "name": "main", "status": "up", "ram": 256, "service_key": null, "database_type": "postgres", "closed": false, "blob": null }
],
"status": { "up": 2, "down": 0, "building": 0, "total": 2 },
"ram_total": 768,
"bindings": [
{
"id": "bnd-abc123def456",
"stack_id": "stk-abc123def456",
"app_id": "app-abc123def456",
"database_id": "db-abc123def456",
"blob_id": null,
"target_app_id": null,
"env_map": { "DATABASE_URL": "url" },
"certs_path": "/app/.vertra/certs/db-abc123def456/",
"created_at": "2026-10-27T12:00:00.000Z"
}
],
"template": null,
"update_available": false,
"created_at": "2026-10-27T12:00:00.000Z",
"updated_at": "2026-10-27T12:00:00.000Z"
}
}
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 403 | API_KEY_SCOPE_DENIED | La clave no tiene stacks:read. |
| 404 | STACK_NOT_FOUND | El stack no existe o pertenece a otra cuenta. |
Última modificación el 28 de octubre de 2026