Fly.io
Machines

Destroy Machine

View as Markdown

Delete a specific Machine within an app by Machine ID, with an optional force parameter to force kill the Machine if it's running.

DELETE
/apps/{app_name}/machines/{machine_id}

Delete a specific Machine within an app by Machine ID, with an optional force parameter to force kill the Machine if it's running.

Authorization

bearerAuth
AuthorizationBearer <token>

A Fly.io access token. Create one with fly tokens create.

In: header

Path Parameters

app_name*string

Fly App Name

machine_id*string

Machine ID

Query Parameters

force?boolean

Force kill the machine if it's running

Response Body

curl -X DELETE "https://example.com/apps/string/machines/string"
Empty

Update Machine POST

Update a Machine's configuration using the details provided in the request body.

Cordon Machine POST

“Cordoning” a Machine refers to disabling its services, so the Fly Proxy won’t route requests to it. In flyctl this is used by blue/green deployments; one set of Machines is started up with services disabled, and when they are all healthy, the services are enabled on the new Machines and disabled on the old ones.