create_machine
Create Machine
Create a new Fly Machine from a container image in a specific region. Configure CPU, memory, GPU resources, networking services, environment variables, volume mounts, and more.
create_machine
Create a new Fly Machine from a container image in a specific region. Configure CPU, memory, GPU resources, networking services, environment variables, volume mounts, and more.
delete_app
Delete a Fly App and all its associated resources. Use force to stop all running Machines before deletion.
create_volume
Create a new persistent storage volume for a Fly App. Volumes provide local persistent storage that can be attached to one Machine at a time. Optionally restore from a snapshot.
list_apps
List all Fly Apps in an organization. Returns app names, machine counts, volume counts, and network configuration for each app.
update_machine
Update a Fly Machine's configuration. Requires the full config object (partial updates are not supported). The machine's region and name are immutable.
wait_for_machine
Block until a Fly Machine reaches a specific state. Useful for orchestrating machine lifecycle operations where you need to wait for a transition to complete.
manage_machine_lease
Acquire, check, or release an exclusive modification lease on a Fly Machine. Leases prevent concurrent updates to the same machine. Use "acquire" before updating, and "release" when done.
control_machine
Start, stop, restart, or suspend a Fly Machine. Also supports cordoning (disabling request routing) and uncordoning (re-enabling request routing).
manage_volume
Get details, update settings, extend size, or delete a Fly Volume. Also supports listing and creating snapshots for a volume.
create_app
Create a new Fly App in an organization. Apps serve as named collections that group Machines, volumes, networking, and secrets. Optionally isolate the app on its own private network.
list_machines
List all Fly Machines in an app. Optionally filter by region or metadata. Returns machine IDs, states, regions, and configuration details.
request_oidc_token
Request an OpenID Connect (OIDC) JWT token for a Machine. This enables Fly Machines to authenticate with external third-party services that accept OIDC tokens.
manage_machine_metadata
Get, set, or delete metadata key-value pairs on a Fly Machine. Metadata can be used for tagging, filtering, and internal routing purposes.
get_app
Retrieve details for a specific Fly App including its status and organization. Use this to check an app's current state before performing operations on it.
get_machine
Retrieve full details of a specific Fly Machine including its configuration, state, events, and image reference.
delete_machine
Permanently destroy a Fly Machine. Use force to stop a running machine before deletion. This action cannot be undone.
manage_secrets
List, set, or delete app-level secrets. Secrets are encrypted at rest and exposed as environment variables to Machines at boot time. Setting secrets does not immediately affect running Machines; they pick up changes on next launch.
manage_certificates
List, request, check, or delete SSL/TLS certificates for custom domains on a Fly App. Supports both automatic ACME (Let's Encrypt) certificates and custom certificate imports.
list_volumes
List all persistent storage volumes for a Fly App. Returns volume IDs, sizes, states, regions, and attachment information.
Provision and manage applications, virtual machines (Machines), persistent storage volumes, secrets, certificates, and networking on the Fly.io cloud platform. Create and deploy containerized workloads to specific geographic regions using fast-launching Firecracker microVMs. Control the full Machine lifecycle—create, start, stop, restart, clone, update, and destroy VMs with configurable CPU, memory, and GPU resources. Manage persistent volumes, allocate IP addresses (Anycast IPv4/IPv6), configure SSL/TLS certificates for custom domains, and set app-level secrets. Query Prometheus-compatible metrics for monitoring HTTP responses, CPU, memory, disk I/O, and network traffic. Generate OIDC tokens for external service authentication.
Common questions about connecting Flyio to AI agents with Metorial.