| title | Machines API |
|---|---|
| description | Manage apps, Machines, volumes, certificates and tokens with the Fly.io Machines REST API. Find each resource reference, the OpenAPI spec and the fly-go client. |
| source_url | https://fly.io/docs/machines/api/ |
The Fly Machines REST API provides resources to provision and manage Fly Apps, Fly Machines, and Fly Volumes.
-
Working with the Machines API: Get set up quickly to use the Machines API.
-
Machines resource: The core of the Machines API. Use the Machines resource to fully control Machines at speed.
-
Apps resource: Create and manage Fly Apps to group and administer your Machines.
-
Certificates resource: Manage SSL/TLS certificates for custom domains.
-
Tokens resource: Request an OpenID Connect token from a 3rd-party.
-
Volumes resource: Create and manage persistent storage volumes for your Machines.
-
OpenAPI spec: OpenAPI 3.0 specification for the Machines API.
You can call the Machines API from any HTTP client. The official packages from Fly.io:
-
fly-go: Go client for the Machines API and the Fly.io GraphQL API. It's the library flyctl is built on. Module
github.com/superfly/fly-go. -
Other languages: generate a client from the OpenAPI spec with a tool like openapi-generator.
Fly Sprites is a separate API (api.sprites.dev) with its own SDKs: @fly/sprites for JavaScript and TypeScript, sprites-py for Python, sprites-go for Go, sprites for Elixir, and an MCP server.
