Update a demo base stack

Change the mutable designation of a demo base stack: profile, profile version, parameters, and idle TTL. The name (and thus the namespace) is immutable and ignored here; an omitted profile_id keeps the current profile. Changes are refused while the stack is deploying or deleting, and take effect on the next materialisation. Organisation-admin only; browser session authentication with the X-Ankra-CSRF double-submit header (no bearer twin).

PUT /org/ai-environment/demo-base-stacks/{base_stack_id}

Update a demo base stack

Python

import requests

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

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

200

{
  "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.

Path Parameters

base_stack_id · string<uuid> · required

Body

application/json

The update payload of a demo base stack. name is immutable and ignored here; an omitted profile_id keeps the current profile.

idle_ttl_hours · integer | null

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

parameters · object[]

Show child attributes

profile_id · string<uuid> | null

profile_version · integer | null

Null tracks the profile's current version.

Response

200

application/json

The base stack after the write

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.