Fly

45 tools available

Fly.io transforms containers into micro-VMs that run on hardware in 30+ regions on six continents.

Connect Fly to Definable to triage issues, review pull requests, monitor builds. Personas call Fly's 45 tools directly from chat or scheduled flows. Wire it into a triage, review, or release-management persona — every action runs scoped, reviewable, and logged.

Common workflows with Fly

Triage incoming issues

Webhook fires on every new issue
Persona summarises and labels it
Assigns the right engineer

Auto-review PRs

Pull the diff
Run a code-review persona
Post structured feedback as PR comment

Failing-build alerts

CI sends a failure event
Agent inspects logs and stack trace
Drops a debug summary in Slack

Release notes from commits

Read commits since last tag
Group by type with the model
Post to a changelog channel

Fly actions 45

Every Fly action below is a callable tool any Definable persona can invoke.

Add WireGuard Peer

Tool to add a WireGuard peer connection to a Fly.io organization for private network access. Use when setting up VPN access or private networking between your infrastructure and Fly.io.

Check App Name Availability

Tool to validate an app name for Fly.io app creation. Use when you need to check if a proposed app name is available before attempting to create a new app. Returns availability status via GraphQL query.

Check Jobs

Execute GraphQL queries against the Fly.io checkJobs endpoint. Retrieves check jobs with their schedules, URLs, and configuration. Supports pagination via first/last/after/before parameters. Returns both data and errors for flexible error handling.

Check User Only Token

Check whether the authentication token only allows user access. Returns false if the token allows organization access, true if it only allows user access.

Create Health Check Job

Tool to create a health check job for monitoring application endpoints in Fly.io. Use when you need to set up automated health monitoring for a URL from multiple geographic locations.

Create Check Job Run

Triggers a run of an existing health check job on Fly.io. Use when you need to manually trigger a health check for monitoring or testing purposes.

Create Delegated WireGuard Token

Tool to create a delegated WireGuard token for peer management in a Fly.io organization. Use when you need to generate a token for managing WireGuard peers with delegated access.

Create Third-Party Configuration

Tool to create a third-party service configuration for discharging macaroon caveats. Use when you need to configure external authorization services for Fly.io token validation.

Delete Delegated WireGuard Token

Tool to delete a delegated WireGuard token from a Fly.io organization. Use when you need to revoke or remove an existing WireGuard token that was previously created. Either token or name must be provided to identify which token to delete.

Delete Organization

Tool to delete a Fly.io organization and all its associated resources using the GraphQL API. Use when you need to permanently remove an organization. This operation is irreversible.

Delete Remote Builder

Tool to delete a remote builder configuration for a Fly.io organization. Use when you need to remove the remote builder setup from an organization.

Delete Third Party Configuration

Tool to delete a third-party service configuration from Fly.io. Use when you need to remove an existing third-party service integration or configuration that was previously created.

Detach Postgres Cluster

Tool to detach a Postgres cluster from a Fly.io application, revoking access credentials. Use when you need to remove database connectivity from an application.

Establish SSH Key

Tool to establish an SSH key for a Fly.io organization. Use when setting up SSH access for secure connections to Fly.io infrastructure.

Fetch Nodes by IDs

Fetches a list of node objects from Fly.io given a list of IDs using the GraphQL nodes query. Use when you need to retrieve multiple objects by their IDs in a single request. Supports all Node interface types including Organization, App, Machine, Volume, and more.

Get Add-On

Tool to find a Fly.io add-on by ID, name, or provider. Use when you need to retrieve details about a specific add-on. Returns add-on information including status, organization, region, and access URLs.

Get Add-On Provider

Tool to query information about a specific Fly.io add-on provider (extension) by name. Returns provider details including provisioning settings, terms of service, and configuration options.

Get app details

Tool to retrieve detailed information about a specific Fly.io application. Use when you need to get app details including certificates and configuration.

Get Certificate

Tool to retrieve a certificate by its ID from Fly.io. Use when you need to get details about a specific certificate including hostname, creation date, and configuration status.

Get Current Token Info

Tool to get information about the current authentication token. Use when you need to retrieve details about the token being used for API authentication, including organizations, apps, and whether the token is from a user or machine.

Get Latest Image Details

Tool to retrieve the latest available tag details for a given image repository from Fly.io's registry. Use when you need to get digest, registry, repository, tag, and version information for a container image.

Get Latest Image Tag

Tool to retrieve the latest available image tag for a Fly.io Docker repository. Use when you need to find the most recent version of a Fly.io image.

Get Machine

Tool to get a single machine by ID from Fly.io. Use when you need to retrieve details about a specific machine instance.

Get Nearest Region

Tool to retrieve the nearest Fly.io region to the requesting client based on network location. Use when you need to determine which Fly.io region has the lowest latency from the current location.

Get Node by ID

Tool to fetch an object by its globally unique ID using Fly.io's GraphQL node query. Returns a Node interface object with id and __typename fields. Use when you need to retrieve any Fly.io object by its ID.

Get Organization

Tool to find a Fly.io organization by slug using the GraphQL API. Use when you need to retrieve organization details including ID, name and slug.

Get Personal Organization

Tool to retrieve the user's personal organization details from Fly.io. Use when you need to check credit balance, saved payment methods, certificates, or WireGuard peer information.

Get Placements

Tool to get placement recommendations for Machines in Fly.io regions. Use when you need to determine optimal regions for deploying machines based on resource requirements, volume constraints, and organizational limits.

Get Platform Information

Tool to retrieve Fly.io platform information including available regions, VM sizes, and flyctl version. Use when you need infrastructure-level details about the Fly.io platform.

Get Products and Pricing

Tool to retrieve Fly.io product and price information via GraphQL. Use when you need to fetch product catalog, pricing tiers, or billing information.

Get Regions

Tool to get the list of available Fly.io regions with optional filtering. Use when you need to discover which regions are available for deploying machines, or to filter regions by specific resource requirements like CPU, memory, or GPU.

Get Viewer Info

Tool to retrieve the authenticated user's account information from Fly.io. Use when you need to get the current user's profile details, including avatar, email, creation date, and feature flags.

Issue Certificate

Tool to issue an SSH certificate for accessing Fly.io infrastructure. Returns an SSH certificate in OpenSSH format. Use when you need to authenticate SSH access to Fly.io machines or apps.

List Add-On Plans

Tool to list available add-on service plans from Fly.io. Use when you need to discover pricing, features, and resource limits for Fly.io add-on services. Supports cursor-based pagination.

List Add-Ons

Tool to list add-ons associated with an organization in Fly.io. Use when you need to retrieve add-ons for apps in an organization. Supports querying personal organization or specific organizations by slug. Returns comprehensive add-on details including status, creation date, and configuration.

List Apps

Tool to list all Fly Apps in an organization. Use when you need to retrieve apps for a specific organization using its slug.

List Apps via GraphQL

List all Fly.io applications with details including volumes, services, and VMs using GraphQL. Use when you need to retrieve a comprehensive overview of all apps in your Fly.io organization.

Check Locations

Retrieve all available Fly.io health check locations. Returns a comprehensive list of global locations where health checks can be performed, including geographic details and coordinates. Use when you need to determine available monitoring points for setting up health checks.

List Machines

Tool to list Fly.io machines using GraphQL API with pagination support. Use when you need to retrieve information about deployed machines including their state, region, and creation time.

List Organization Machines

Tool to list all Machines across all apps in a Fly organization. Use when you need to retrieve machines for monitoring, management, or inventory purposes. Supports filtering by region, state, and time ranges with pagination for large result sets.

Remove WireGuard Peer

Tool to remove a WireGuard peer connection from a Fly.io organization. Use when you need to delete or revoke an existing WireGuard peer from your organization's network.

Set Apps V2 Default

Tool to configure whether new apps in an organization use Apps V2 by default on Fly.io. Use when you need to enable or disable Apps V2 as the default for new applications in a specific organization.

Update Third-Party Configuration

Tool to update an existing third-party service configuration for discharging macaroon caveats. Use when you need to modify settings of external authorization services for Fly.io token validation.

Validate Config

Tool to validate a Fly.io app configuration. Use when you need to check if a fly.toml configuration is valid before deploying or updating an app.

Validate WireGuard Peers

Tool to validate WireGuard peer IP addresses in a Fly.io organization. Use when you need to verify which peer IPs are valid or invalid before establishing VPN connections.

Frequently asked questions

What can I automate with Fly on Definable?

Anything Fly exposes through its API. Common developer tools workflows on Definable include triage issues, review pull requests, monitor builds. Personas can call any of the 45 Fly tools directly, then chain the result into another integration without you writing code.

How does Fly authentication work?

Fly uses API_KEY, OAUTH2 on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Fly integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 45 Fly tools. You only need a separate Fly subscription if Fly itself charges per seat or per API call.

Is using Fly through Definable secure?

Every call from a persona to Fly is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Fly on Definable?

Sign up for Definable, open the integrations page, find Fly, and connect via OAuth or API key. You can immediately attach Fly to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Fly actions does Definable expose?

Definable exposes all 45 Fly actions as callable tools — including `Add WireGuard Peer`, `Check App Name Availability`, `Check Jobs`, plus 42 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Fly?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations