{"slug":"fly-io-machines-api","name":"Fly.io Machines API","host":"api.machines.dev","site":"https://machines.dev","category":"cloud","docsUrl":null,"sources":[{"kind":"changelog","url":"https://community.fly.io/c/fresh-produce/27.rss"},{"kind":"archive","url":"https://docs.machines.dev/openapi.json"}],"url":"https://www.okapi.bot/providers/fly-io-machines-api/","json":"https://www.okapi.bot/api/v1/providers/fly-io-machines-api.json","breakingChanges":[{"slug":"instance-id-on-get-v1-apps-machines-wait-is-deprecated","api":"fly-io-machines-api","title":"instance_id on GET /v1/apps/{}/machines/{}/wait is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /v1/apps/{}/machines/{}/wait","query parameter instance_id"],"method":"GET","path":"/v1/apps/{}/machines/{}/wait","source":{"url":"https://docs.machines.dev/openapi.json","kind":"archive"},"quote":"26-character Machine version ID (deprecated; use version)","migration":"Send the Machine version ID as version instead of instance_id.","migrationChange":null,"needsDecision":null,"text":{"summary":"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.","migration":"Send the Machine version ID as version instead of instance_id.","by":"writer"},"publishedAt":"2026-10-23T10:41:36.302Z","updatedAt":"2026-10-26T21:37:15.526Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/fly-io-machines-api/breaking-changes/instance-id-on-get-v1-apps-machines-wait-is-deprecated/"},{"slug":"put-v1-apps-machines-metadata-is-deprecated","api":"fly-io-machines-api","title":"PUT /v1/apps/{}/machines/{}/metadata is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["PUT /v1/apps/{}/machines/{}/metadata"],"method":"PUT","path":"/v1/apps/{}/machines/{}/metadata","source":{"url":"https://docs.machines.dev/openapi.json","kind":"archive"},"quote":"Deprecated: use `PATCH` on the same path, which this is identical to.","migration":"Send PATCH /v1/apps/{app_name}/machines/{machine_id}/metadata with the same body.","migrationChange":null,"needsDecision":null,"text":{"summary":"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.","migration":"Send PATCH /v1/apps/{app_name}/machines/{machine_id}/metadata with the same body instead.","by":"writer"},"publishedAt":"2026-10-23T10:41:36.302Z","updatedAt":"2026-10-26T21:37:14.852Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/fly-io-machines-api/breaking-changes/put-v1-apps-machines-metadata-is-deprecated/"}]}