> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vast.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# VastAI.update_instance

Update/recreate an instance from a new/updated template.

## Signature

```python theme={null}
VastAI.update_instance(
    id: int,
    template_id: Optional[int] = None,
    template_hash_id: Optional[str] = None,
    image: Optional[str] = None,
    args: Optional[str] = None,
    env: Optional[str] = None,
    onstart: Optional[str] = None
) -> str
```

## Parameters

<ParamField path="id" type="int" required>
  id
</ParamField>

<ParamField path="template_id" type="Optional[int]">
  template\_id
</ParamField>

<ParamField path="template_hash_id" type="Optional[str]">
  template\_hash\_id
</ParamField>

<ParamField path="image" type="Optional[str]">
  image
</ParamField>

<ParamField path="args" type="Optional[str]">
  args
</ParamField>

<ParamField path="env" type="Optional[str]">
  env
</ParamField>

<ParamField path="onstart" type="Optional[str]">
  onstart
</ParamField>

## Returns

`str`, Result from the API call.

## Example

```python theme={null}
from vastai import VastAI

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