Create a demo base stack

Save a new shared demo base stack in status 'configured'. Nothing reaches the cluster here - materialisation happens on the first demo launch that references it. Organisation-admin only; browser session authentication with the X-Ankra-CSRF double-submit header (no bearer twin). Secret parameter values ride as ${SECRET_SLOT:<uuid>} sentinels, never resolved values.

POST /org/ai-environment/demo-base-stacks

Create a demo base stack

Python

import requests

url = "https://platform.ankra.app/org/ai-environment/demo-base-stacks"

payload = {
    "name": "<string>",
    "profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

201

{
  "cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "live_demo_count": 123,
  "name": "<string>",
  "namespace": "<string>",
  "parameters": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "configured",
  "idle_ttl_hours": 123,
  "last_error": "<string>",
  "last_used_at": "2023-11-07T05:31:56Z",
  "profile_name": "<string>",
  "profile_version": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

The create payload of a demo base stack. Secret parameter values ride as ${SECRET_SLOT:} sentinels. The literal ${BASE_STACK_NAMESPACE} in a parameter value is substituted with the base stack's stable namespace when the stack is materialised.

name · string · required

A lowercase DNS label of at most 30 characters; immutable once created (it derives the stable namespace).

profile_id · string<uuid> · required

idle_ttl_hours · integer | null

Between 1 and 720 hours; null disables the idle TTL.

parameters · object[]

Show child attributes

profile_version · integer | null

Null tracks the profile's current version.

Response

201

application/json

The created base stack

One shared demo base stack: an organisation-level stack-profile designation that materialises lazily as a persistent stack in a stable ankra-demo-base-* namespace on the staging cluster. Status is one of: configured (saved, never materialised), deploying, ready, failed, deleting, deleted.

cluster_id · string<uuid> · required

created_at · string<date-time> · required

id · string<uuid> · required

live_demo_count · integer · required

The number of non-destroyed demos referencing this base stack; deletion is refused while it is non-zero.

name · string · required

namespace · string · required

parameters · object[] · required

Show child attributes

profile_id · string<uuid> · required

status · enum<string> · required

Available options: configured, deploying, ready, failed, deleting, deleted

idle_ttl_hours · integer | null

Idle hours after which the maintainer loop tears the stack down; null disables the idle TTL.

last_error · string

last_used_at · string<date-time> | null

profile_name · string

Denormalized onto reads only (never persisted).

profile_version · integer | null

Null tracks the profile's current version.