# PUT /v1/apps/{}/machines/{}/metadata is deprecated

Fly.io Machines API deprecated PUT /v1/apps/{id}/machines/{id}/metadata without giving a shutdown date yet.

Fly.io deprecated the PUT /v1/apps/{id}/machines/{id}/metadata endpoint without announcing a shutdown date. Calls made to this route are marked for removal and will eventually fail. Fly.io Machines API notes that the operation is identical to the PATCH method on the same path.

## What to use instead

Send PATCH /v1/apps/{app_name}/machines/{machine_id}/metadata with the same body instead.

- API: Fly.io Machines API (api.machines.dev)
- Kind: Endpoint removal
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `PUT /v1/apps/{id}/machines/{id}/metadata`
- Source: [Announcement](https://docs.machines.dev/openapi.json)
- Verified: November 6, 2026, against Fly.io Machines API's own pages
- Page: https://www.okapi.bot/providers/fly-io-machines-api/breaking-changes/put-v1-apps-machines-metadata-is-deprecated/

## Fly.io Machines API's words

> Deprecated: use `PATCH` on the same path, which this is identical to.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent