---
title: "/instances/{id}/update"
method: POST
path: "/instances/{id}/update"
---

# /instances/{id}/update

`POST /instances/{id}/update`

Update mutable details about the instance. Set a value to null to delete it. Omit a value or leave undefined to keep unchanged.

## Request body

- UpdateRequest
  - `name` string — The name of the instance
  - `auto_delete` AutoDelete — Set a date or spend threshold to automatically delete the instance
    - `date_threshold` string — RFC3339 date string
    - `spend_threshold` string — Valid decimal representation of a dollar amount
  - `alert` Alert — Set a date or spend threshold to receive an email alert
    - `date_threshold` string — RFC3339 date string
    - `spend_threshold` string — Valid decimal representation of a dollar amount
  - `tags` Tag[] — Add custom, searchable tags to instances.

## Response `200`

Confirms the update of an instance.

---

[API](https://skmtc.net/shadeform/apis/shadeform-api.md) · [All operations](https://skmtc.net/shadeform/apis/shadeform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shadeform/shadeform-api/versions/e1750dca8851/schema)