Overview

REST API reference for managing Fly Machines, apps, volumes, secrets, and certificates.

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.

Download OpenAPI spec

Base URL

All requests are made against:

https://api.machines.dev/v1

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.

curl https://api.machines.dev/v1/apps?org_slug=personal \
  -H "Authorization: Bearer $FLY_API_TOKEN"

Resources

Apps

Group your Machines into apps.

Machines

Launch and control fast-booting VMs.

Volumes

Persistent storage for your Machines.

Secrets

App secrets and encryption keys.

TLS Certificates

Certificates for custom hostnames.

Tokens

Authenticate and mint access tokens.