Update a demo base stack

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)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://platform.ankra.app/org/ai-environment/demo-base-stacks/{base_stack_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request PUT \
  --url https://platform.ankra.app/org/ai-environment/demo-base-stacks/{base_stack_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "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",
  "idle_ttl_hours": 123,
  "last_error": "<string>",
  "last_used_at": "2023-11-07T05:31:56Z",
  "profile_name": "<string>",
  "profile_version": 123
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

AI Environment

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

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)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://platform.ankra.app/org/ai-environment/demo-base-stacks/{base_stack_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request PUT \
  --url https://platform.ankra.app/org/ai-environment/demo-base-stacks/{base_stack_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "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",
  "idle_ttl_hours": 123,
  "last_error": "<string>",
  "last_used_at": "2023-11-07T05:31:56Z",
  "profile_name": "<string>",
  "profile_version": 123
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

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

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

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.

API reference

Endpoints

Update a demo base stack

Authorizations

Path Parameters

Body

Response