Get 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
Get Stack
Returns one stack with its members, status, connections, memory total and the template it came from.
GET
/
v1
/
stacks
/
{stack_id}
Get 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"
}
}
Returns a stack and everything in it: applications, databases and Blob folders, the connections between them, the status of the members added up and, when the stack came from a template, the template and version. Needs the
stacks:read scope when called with an API key.
string
required
The stack ID.
string
The workspace the stack belongs to. Required for a workspace member acting on a stack they do not own; the owner may omit it.
Response
object
The stack.
Show Toggle object
Show Toggle object
string
The stack ID.
string
The stack name.
string | null
Optional description, or
null.string
How the members reach each other. The value is
public: services use their public addresses and databases are reached with client certificates.string
The account that owns the stack.
string | null
The workspace the stack belongs to, or
null when it belongs to you.object[]
The members. Each has
resource_type (application, database or blob), resource_id, name, status (null for a Blob folder), ram in MB (0 for a Blob folder), service_key (the service id in the template, null for a member you added), database_type (the engine of a database, otherwise null), closed (true for an application of a closed template: its code is not accessible) and blob.For a Blob member, blob has the folder prefix, visibility (private or public), used_bytes (or null) and api_key_id, the key the platform created for the stack and restricted to that folder. See Add Blob Folder.object
Members online, offline and building, added up:
up, down, building and total (the members that have a status).integer
Memory of every member, in MB.
object[]
The connections between members. Each has
id, stack_id, app_id (the application that receives the variables), exactly one of database_id, blob_id and target_app_id, env_map (variable name to what it receives), certs_path (the folder inside the application where the client certificates of a database are written, null without a database) and created_at. See Create Connection.object | null
The template and version the stack came from, or
null for a stack assembled by hand. It has the same fields as the template of an application, including icon_url, the stable URL of the template icon (null when there is none).boolean
true when the template has a newer version the stack can update to.string
When the stack was created.
string
When the stack was last updated.
{
"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"
}
}
Errors
| Status | Code | When |
|---|---|---|
| 403 | API_KEY_SCOPE_DENIED | The key does not have stacks:read. |
| 404 | STACK_NOT_FOUND | The stack does not exist or belongs to another account. |
Last modified on October 28, 2026