v1

latestOpenAPI 3.0.1Apache 2.02026-07-1476137102.3 KB

Machines

List Machines

List all Machines associated with a specific app, with optional filters for including deleted Machines and filtering by region.

get/apps/{app_name}/machines

app_namestring required

Fly App Name

include_deletedboolean

Include deleted machines

include_leasesboolean

Include machine leases

regionstring

Region filter

statestring

comma separated list of states to filter (created, started, stopped, suspended)

summaryboolean

Only return summary info about machines (omit config, checks, events, host_status, nonce, etc.)

cordonedboolean

created_atstring

host_status'ok' | 'unknown' | 'unreachable'

idstring

instance_idstring

InstanceID is unique for each version of the machine

namestring

noncestring

Nonce is only every returned on machine creation if a lease_duration was provided.

private_ipstring

PrivateIP is the internal 6PN address of the machine.

regionstring

statestring

updated_atstring