fly-io logo

fly-io

Documentation and guides from the team at Fly.io.

3 APIs 16 Features

APIs

Fly.io Machines API

The Fly.io Machines API is a low-level REST interface for provisioning and managing Fly Machines, which are fast-booting virtual machines that run on Fly.io's global edge infras...

Fly.io GraphQL API

The Fly.io GraphQL API provides a programmatic interface for managing Fly.io platform resources including applications, IP address allocations, organizations, and networking con...

Fly.io Extensions API

The Fly.io Extensions API is a provider-facing HTTP interface that enables third-party services to integrate with the Fly.io platform as extension providers. When a Fly.io user ...

Features

Shared CPU machines: shared-cpu-1x to 8x with 256MB-16GB RAM
Performance CPU machines: performance-1x to 16x with 2GB-128GB RAM
Per-second billing while machines run
Stopped machines: $0.15/GB rootfs per 30 days
Volumes: $0.15/GB/month persistent storage
Snapshots: $0.08/GB/month (10 GB free)
Egress: $0.02-$0.12/GB (region-grouped)
Dedicated IPv4: $2/month; unlimited Anycast IPv6 free
Managed SSL: $0.10/single, $1/wildcard
Machine Reservation Blocks: 40% compute discount with annual commit
Fly Kubernetes (FKS): $75/cluster/month + underlying resources
Static Egress IPs: $0.005/hour (~$3.60/mo)
Machines API for programmatic instance management
Anycast routing for global load balancing
Postgres, Redis, Upstash add-on services
WireGuard mesh for private networking

Event Specifications

Fly.io Extensions Webhook Events

The Fly.io Extensions webhook system delivers real-time event notifications in both directions between Fly.io and extension providers. Fly.io sends CloudEvents-format payloads t...

ASYNCAPI

Semantic Vocabularies

Fly Io Context

0 classes · 11 properties

JSON-LD

Resources

👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
JSONSchema
JSONSchema
🔗
JSONSchema
JSONSchema
🔗
JSONLD
JSONLD

Sources

Raw ↑
aid: fly-io
url: https://raw.githubusercontent.com/api-evangelist/fly-io/refs/heads/main/apis.yml
apis:
- aid: fly-io:machines-api
  name: Fly.io Machines API
  tags:
  - Deployment
  - Edge Computing
  - Infrastructure
  - Platform
  - Virtual Machines
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.machines.dev
  humanURL: https://fly.io/docs/machines/api/
  properties:
  - url: https://fly.io/docs/machines/api/
    type: Documentation
  - url: https://fly.io/docs/machines/api/working-with-machines-api/
    type: Documentation
  - url: openapi/fly-io-machines-api-openapi.yml
    type: OpenAPI
  description: >-
    The Fly.io Machines API is a low-level REST interface for provisioning and managing Fly Machines, which are
    fast-booting virtual machines that run on Fly.io's global edge infrastructure. It provides endpoints for creating,
    starting, stopping, and destroying Machines, as well as managing Fly Apps, Fly Volumes, and TLS certificates. The
    API is accessible publicly at https://api.machines.dev or internally within the Fly.io private WireGuard network
    at http://_api.internal:4280.
- aid: fly-io:graphql-api
  name: Fly.io GraphQL API
  tags:
  - Deployment
  - GraphQL
  - Infrastructure
  - Networking
  - Platform
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.fly.io/graphql
  humanURL: https://api.fly.io/graphql
  properties:
  - url: https://api.fly.io/graphql
    type: Documentation
  - url: graphql/fly-io-graphql.md
    type: GraphQL
  description: >-
    The Fly.io GraphQL API provides a programmatic interface for managing Fly.io platform resources including
    applications, IP address allocations, organizations, and networking configuration. The endpoint is available at
    https://api.fly.io/graphql and includes an interactive GraphiQL explorer with schema introspection and
    documentation tabs accessible directly in the browser. Authentication requires an Authorization Bearer token,
    which can be obtained by running `flyctl auth token`.
- aid: fly-io:extensions-api
  name: Fly.io Extensions API
  tags:
  - Extensions
  - Integration
  - Partner
  - Platform
  - Provisioning
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.example.com
  humanURL: https://fly.io/docs/reference/extensions_api/
  properties:
  - url: https://fly.io/docs/reference/extensions_api/
    type: Documentation
  - url: https://fly.io/docs/about/extensions/
    type: Documentation
  - url: openapi/fly-io-extensions-api-openapi.yml
    type: OpenAPI
  - url: asyncapi/fly-io-extensions-webhooks-asyncapi.yml
    type: AsyncAPI
  description: >-
    The Fly.io Extensions API is a provider-facing HTTP interface that enables third-party services to integrate with
    the Fly.io platform as extension providers. When a Fly.io user provisions an extension via the flyctl CLI, Fly.io
    forwards the provisioning request to the provider's API with details about the requesting organization, and the
    provider responds with environment variable configuration that is attached to the target application.
common:
- type: GitHubOrganization
  url: https://github.com/superfly
- type: LinkedIn
  url: https://www.linkedin.com/company/fly-io
- type: JSONSchema
  url: json-schema/fly-io-machine-schema.json
- type: JSONSchema
  url: json-schema/fly-io-volume-schema.json
- type: JSONLD
  url: json-ld/fly-io-context.jsonld
- type: Features
  data:
  - 'Shared CPU machines: shared-cpu-1x to 8x with 256MB-16GB RAM'
  - 'Performance CPU machines: performance-1x to 16x with 2GB-128GB RAM'
  - Per-second billing while machines run
  - 'Stopped machines: $0.15/GB rootfs per 30 days'
  - 'Volumes: $0.15/GB/month persistent storage'
  - 'Snapshots: $0.08/GB/month (10 GB free)'
  - 'Egress: $0.02-$0.12/GB (region-grouped)'
  - 'Dedicated IPv4: $2/month; unlimited Anycast IPv6 free'
  - 'Managed SSL: $0.10/single, $1/wildcard'
  - 'Machine Reservation Blocks: 40% compute discount with annual commit'
  - 'Fly Kubernetes (FKS): $75/cluster/month + underlying resources'
  - 'Static Egress IPs: $0.005/hour (~$3.60/mo)'
  - Machines API for programmatic instance management
  - Anycast routing for global load balancing
  - Postgres, Redis, Upstash add-on services
  - WireGuard mesh for private networking
  sources:
  - https://fly.io/docs/about/pricing/
  updated: '2026-05-04'
modified: '2026-05-19'
description: Documentation and guides from the team at Fly.io.