# instance_id on GET /v1/apps/{}/machines/{}/wait is deprecated

Fly.io Machines API deprecated GET /v1/apps/{}/machines/{}/wait, query parameter instance_id without giving a shutdown date yet.

The Fly.io Machines API deprecated the instance_id query parameter on GET /v1/apps/{}/machines/{}/wait without a shutdown date. The provider notes that the 26-character Machine version ID is deprecated; use version. Affected calls that rely on this parameter will fail once removed.

## What to use instead

Send the Machine version ID as version instead of instance_id.

- 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: `GET /v1/apps/{}/machines/{}/wait`, `query parameter instance_id`
- 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/instance-id-on-get-v1-apps-machines-wait-is-deprecated/

## Fly.io Machines API's words

> 26-character Machine version ID (deprecated; use version)

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