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

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

Fly.io deprecated the PUT /v1/apps/{}/machines/{}/metadata endpoint without announcing a shutdown date. Calls made to this route are marked for removal and will eventually fail. The provider 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/{}/machines/{}/metadata`
- Source: [Announcement](https://docs.machines.dev/openapi.json)
- Verified: October 27, 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