---
title: "Update Metadata (set/remove multiple keys)"
method: PATCH
path: "/apps/{app_name}/machines/{machine_id}/metadata"
tags: ["Machines"]
---

# Update Metadata (set/remove multiple keys)

`PATCH /apps/{app_name}/machines/{machine_id}/metadata`

Update multiple metadata keys at once. Null values and empty strings remove keys.
+ If `machine_version` is provided and no longer matches the current machine version, returns 412 Precondition Failed.

## Path parameters

- `app_name` string, required
- `machine_id` string, required

## Request body

- UpdateMetadataRequest
  - `machine_version` string
  - `metadata` object
  - `updated_at` string

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `412` — Precondition Failed

---

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