Update a member SandboxPool

Authorization

ApiKeyAuth

AGENTBOX-API-KEY<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

instanceType?string

InstanceType catalog entry. Required when the Pool's Env is billed (env.poolSizing=billed); rejected when its Env is free-form (env.poolSizing=free-form); the caller's choice when the Env is unmanaged (env.poolSizing=either). May be combined with inlineResources to reserve a whole instance while running a smaller (rounded-down) Pod.

multiplier?integer

Multiplier applied to the InstanceType base resources to form the reservation envelope. Defaults to 1.

Formatint32

Range1 <= value

inlineResources?

Explicit per-Pool resource requests/limits. Required — and used alone — when the Pool's Env is free-form (env.poolSizing=free-form), where it is the whole of the Pod's sizing; on a billed Env it is optional and instead combined with instanceType as the rounded-down actual Pod request (must fit within instanceType × multiplier). Sets both requests and limits.

replicas?integer

Initial replica count. Autoscaling, once enabled on this scalingGroup, owns subsequent changes.

Formatint32

Range0 <= value

minReplicas?integer

Lower bound on this pool's replicas, enforced as a per-member scale-down floor by the Env autoscaler.

Formatint32

Range0 <= value

maxReplicas?integer

Upper bound on this pool's replicas, enforced when the Env autoscaler distributes scale-up delta.

Formatint32

labels?

Labels stamped onto this member's SandboxPool. Use for plugin-driven metadata such as quota.scitix.ai/url (parsed by the server to derive the pool-name suffix). Required when the Pool's Env is billed (env.poolSizing=billed) — the Pool is rejected without it, because the scheduler it is submitted to has nothing to charge; rejected when the Env is free-form.

annotations?

Annotations stamped onto this member's SandboxPool.

updateStrategy?

Per-member rollout policy override. Unset inherits the Env overrides.updateStrategy, then autoUpdate=true / maxUnavailable=20%.

Response Body

`application/json`

curl -X PUT "https://envs/string/sandboxpools/string" \  -H "Content-Type: application/json" \  -d '{    "instanceType": "sci.c23-2",    "multiplier": 1,    "replicas": 1,    "minReplicas": 0,    "maxReplicas": 4,    "inlineResources": {      "requests": {        "cpu": "100m",        "memory": "500Mi"      },      "limits": {        "cpu": "100m",        "memory": "500Mi"      }    },    "labels": {      "quota.scitix.ai/url": "https://quota.example/q/1"    }  }'

{  "template": {    "name": "poolname",    "namespace": "t-team-user",    "cpu": "1",    "memory": "16Gi",    "team": "team",    "user": "user",    "spec": {      "replicas": 2    },    "status": {      "phase": "Ready",      "idleReplicas": 1,      "unavailableIdleReplicas": 0,      "runningReplicas": 1,      "startingReplicas": 0,      "stoppingReplicas": 0,      "failedReplicas": 0    }  },  "editable": {    "instanceType": "sci.c23-2",    "multiplier": 1,    "replicas": 1,    "minReplicas": 0,    "maxReplicas": 4,    "inlineResources": {      "requests": {        "cpu": "100m",        "memory": "500Mi"      },      "limits": {        "cpu": "100m",        "memory": "500Mi"      }    },    "labels": {      "quota.scitix.ai/url": "https://quota.example/q/1"    }  }}

{  "error": "string",  "errorCode": "APPROVAL_REQUIRED",  "detail": null}

{  "error": "string",  "errorCode": "APPROVAL_REQUIRED",  "detail": null}

{  "error": "string",  "errorCode": "APPROVAL_REQUIRED",  "detail": null}

{  "error": "string",  "errorCode": "APPROVAL_REQUIRED",  "detail": null}

{  "error": "string",  "errorCode": "APPROVAL_REQUIRED",  "detail": null}

Update a member SandboxPool

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

404application/json

500application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`