Skip to main content
Update an existing autoscale worker group.

​
Signature

VastAI.update_workergroup(
    id: int,
    min_load: Optional[float] = None,
    target_util: Optional[float] = None,
    cold_mult: Optional[float] = None,
    cold_workers: Optional[int] = None,
    test_workers: Optional[int] = None,
    gpu_ram: Optional[float] = None,
    template_hash: Optional[str] = None,
    template_id: Optional[int] = None,
    search_params: Optional[str] = None,
    no_default: bool = False,
    launch_args: Optional[str] = None,
    endpoint_name: Optional[str] = None,
    endpoint_id: Optional[int] = None
) -> str

​
Parameters

​
id
int
required
ID of the worker group to update.
​
min_load
Optional[float]
Minimum load (requests/sec) below which idle workers are scaled down.
​
target_util
Optional[float]
Target worker utilization ratio (0.0–1.0).
​
cold_mult
Optional[float]
Multiplier applied to warm worker count for pre-warming cold workers.
​
cold_workers
Optional[int]
Number of pre-warmed (cold) workers to keep ready.
​
test_workers
Optional[int]
Number of test workers to spin up during scaling evaluation.
​
gpu_ram
Optional[float]
Minimum GPU RAM in GiB required per worker.
​
template_hash
Optional[str]
Hash of the instance template to use for workers.
​
template_id
Optional[int]
ID of the instance template to use for workers.
​
search_params
Optional[str]
Query string for filtering available GPU offers.
​
no_default
bool
default:"False"
Disable the default search query filters when finding offers.
​
launch_args
Optional[str]
Additional CLI arguments passed when launching worker instances.
​
endpoint_name
Optional[str]
Human-readable name for the endpoint.
​
endpoint_id
Optional[int]
ID of the endpoint this worker group belongs to.

​
Returns

str — Result from the API call.

​
Example

from vastai import VastAI

client = VastAI(api_key="YOUR_API_KEY")
result = client.update_workergroup(id=12345)
print(result)