Skip to main content
This site hosts the API reference generated from the Fly.io Machines API OpenAPI specification. For how to get started, deeper explanations of each endpoint, and examples, visit the complete Machines API docs.

​
Base URL

All requests are made against:

​
Authentication

Authenticate every request with a Fly.io access token using the Authorization: FlyV1 <token> header. Generate one with fly tokens create or the Tokens page on the dashboard.

​
Resources

Apps

Group your Machines into apps.

Machines

Launch and control fast-booting VMs.

Volumes

Persistent storage for your Machines.

Postgres Clusters

Create and manage Postgres clusters.

Secrets

App secrets and encryption keys.

TLS Certificates

Certificates for custom hostnames.

Tokens

Authenticate and mint access tokens.