---
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.

## Changes

- **2025-01-10** `4f156532861d` — 1 info
  - endpoint added
- **2025-01-08** `7483fc077759` — 1 breaking
  - api path removed without deprecation
- **2024-12-20** `913ef3b5a77a` — 1 info
  - endpoint added
- **2024-01-11** `7d5677457388` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/shadeform/apis/shadeform-api/changes/instances/:id/update/post.md)

---

[API](https://skmtc.dev/shadeform/apis/shadeform-api.md) · [All operations](https://skmtc.dev/shadeform/apis/shadeform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shadeform/shadeform-api/revisions/f8304f323e7b/schema)