> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-auto-cli-sdk-preview-pr-398.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# vastai update workergroup

Update an existing autoscale group

## Usage

```bash theme={null}
vastai update workergroup WORKERGROUP_ID --endpoint_id ENDPOINT_ID [options]
```

## Arguments

<ParamField path="id" type="integer" required>
  id of autoscale group to update
</ParamField>

## Options

<ParamField path="--min_load" type="number">
  minimum floor load in perf units/s  (token/s for LLms)
</ParamField>

<ParamField path="--target_util" type="number">
  target capacity utilization (fraction, max 1.0, default 0.9)
</ParamField>

<ParamField path="--cold_mult" type="number">
  cold/stopped instance capacity target as multiple of hot capacity target (default 2.5)
</ParamField>

<ParamField path="--cold_workers" type="integer">
  min number of workers to keep 'cold' for this workergroup
</ParamField>

<ParamField path="--test_workers" type="integer">
  number of workers to create to get an performance estimate for while initializing workergroup (default 3)
</ParamField>

<ParamField path="--gpu_ram" type="number">
  estimated GPU RAM req  (independent of search string)
</ParamField>

<ParamField path="--template_hash" type="string">
  template hash (**Note**: if you use this field, you can skip search\_params, as they are automatically inferred from the template)
</ParamField>

<ParamField path="--template_id" type="integer">
  template id
</ParamField>

<ParamField path="--search_params" type="string">
  search param string for search offers    ex: "gpu\_ram>=23 num\_gpus=2 gpu\_name=RTX\_4090 inet\_down>200 direct\_port\_count>2 disk\_space>=64"
</ParamField>

<ParamField path="--no-default" type="boolean">
  Disable default search param query args
</ParamField>

<ParamField path="--launch_args" type="string">
  launch args  string for create instance  ex: "--onstart onstart\_wget.sh  --env '-e ONSTART\_PATH=[https://s3.amazonaws.com/public.vast.ai/onstart\_OOBA.sh](https://s3.amazonaws.com/public.vast.ai/onstart_OOBA.sh)' --image atinoda/text-generation-webui:default-nightly --disk 64"
</ParamField>

<ParamField path="--endpoint_name" type="string">
  deployment endpoint name (allows multiple workergroups to share same deployment endpoint)
</ParamField>

<ParamField path="--endpoint_id" type="integer">
  deployment endpoint id (allows multiple workergroups to share same deployment endpoint)
</ParamField>

## Description

Example: vastai update workergroup 4242 --min\_load 100 --target\_util 0.9 --cold\_mult 2.0 --search\_params "gpu\_ram>=23 num\_gpus=2 gpu\_name=RTX\_4090 inet\_down>200 direct\_port\_count>2 disk\_space>=64" --launch\_args "--onstart onstart\_wget.sh  --env '-e ONSTART\_PATH=[https://s3.amazonaws.com/public.vast.ai/onstart\_OOBA.sh](https://s3.amazonaws.com/public.vast.ai/onstart_OOBA.sh)' --image atinoda/text-generation-webui:default-nightly --disk 64" --gpu\_ram 32.0 --endpoint\_name "LLama" --endpoint\_id 2

## Global Options

The following options are available for all commands:

| Option          | Description                                           |
| --------------- | ----------------------------------------------------- |
| `--url URL`     | Server REST API URL                                   |
| `--retry N`     | Retry limit                                           |
| `--raw`         | Output machine-readable JSON                          |
| `--explain`     | Verbose explanation of API calls                      |
| `--api-key KEY` | API key (defaults to `~/.config/vastai/vast_api_key`) |