---
title: "Rename or retag (allowed while a job runs)"
method: PATCH
path: "/instances/{instance_id}"
tags: ["instances"]
---

# Rename or retag (allowed while a job runs)

`PATCH /instances/{instance_id}`

## Request

- Base URL: `https://app.lathe.live/api/v1`
- URL: `https://app.lathe.live/api/v1/instances/{instance_id}`
- Auth: none declared

## Path parameters

- `instance_id` string, required

## Request body

- InstancePatch
  - `name` string, nullable: Omit to keep; empty string clears.
  - `tags` string[], nullable: Omit to keep; empty list clears.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lathe/apis/lathe-customer-api.md) · [All operations](https://skmtc.dev/lathe/apis/lathe-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lathe/apis/lathe-customer-api/revisions/68cfd9bb71c1?raw)