Fly.io
Machines

Get Lease

View as Markdown

Retrieve the current lease of a specific Machine within an app. Machine leases can be used to obtain an exclusive lock on modifying a Machine.

GET
/apps/{app_name}/machines/{machine_id}/lease

Retrieve the current lease of a specific Machine within an app. Machine leases can be used to obtain an exclusive lock on modifying a Machine.

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

Response Body

application/json

curl -X GET "https://example.com/apps/string/machines/string/lease"
{  "description": "string",  "expires_at": 0,  "nonce": "string",  "owner": "string",  "version": "string"}

Execute Command POST

Execute a command on a specific Machine and return the raw command output bytes.

Create Lease POST

Create a lease for a specific Machine within an app using the details provided in the request body. Machine leases can be used to obtain an exclusive lock on modifying a Machine.