AI agents for Fly.io

List apps

Lists the organization's apps, as apps: each with id, name, machine_count, volume_count and network; total_apps and next_cursor (with limit) page on.

Get an app

Reads one app: id, status, organization, machine_count, volume_count and network.

List an app's Machines

Lists an app's Machines, as result: each with id, name, state (created, started, stopped, suspended, destroyed …), region, image_ref, private_ip, created_at and updated_at.

Get a Machine

Reads one Machine in full: state, region, image_ref, config (image, guest CPUs and memory, services, env, restart policy), health checks with their status, and recent events.

List a Machine's events

Lists a Machine's latest events, as result: each with type (launch, start, stop, exit, restart, update …), status, source (user or flyd), timestamp (epoch ms) and request (like an exit code).

List an app's volumes

Lists an app's volumes, as result: each with id (vol_…), name, state, region, zone, size_gb, attached_machine_id, encrypted, snapshot_retention and created_at.

Start a Machine

Starts a stopped or suspended Machine (a suspended one resumes from its snapshot when it can).

Stop a Machine

Stops a running Machine: it is sent signal (SIGINT by default, or the app's kill_signal), then killed after timeout.

Restart a Machine

Restarts a Machine in place (stop with signal, wait up to timeout, start again).

Suspend a Machine

Suspends a running Machine, keeping a snapshot of its memory so the next start resumes quickly (Fly.io tries, but cannot promise, to resume rather than boot).