v1

latestOpenAPI 3.0.1Apache 2.02026-07-1476137102.3 KB
Machines

Update Machine

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

post/apps/{app_name}/machines/{machine_id}

Path parameters

app_namestring required

Fly App Name

machine_idstring required

Machine ID

Request body

current_versionstring
lease_ttlinteger
min_secrets_versioninteger
namestring

Unique name for this Machine. If omitted, one is generated for you

regionstring

The target region. Omitting this param launches in the same region as your WireGuard peer connection (somewhere near you).

skip_launchboolean
skip_secretsboolean
skip_service_registrationboolean

Response

OK

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