Fly

fly

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

Developer Tools Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (45)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Add WireGuard PeerFLY_ADD_WIRE_GUARD_PEERAcción

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.

Parámetros de entrada

namestringObligatorio
The name for the WireGuard peer
pubkeystringObligatorio
The Curve25519 public key for the WireGuard peer. Must be a valid base64-encoded 32-byte public key.
regionstring
The region to deploy the WireGuard peer. If not specified, Fly will choose automatically.
networkstring
Network ID to attach the peer to. If not specified, uses the default organization network.
organization_idstringObligatorio
The node ID of the organization to add the WireGuard peer to

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Check App Name AvailabilityFLY_CHECK_APP_NAME_AVAILABILITYAcción

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.

Parámetros de entrada

namestringObligatorio
The app name to check for availability. Must follow Fly.io naming conventions: lowercase letters, numbers, and hyphens only. Cannot start or end with a hyphen.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Check JobsFLY_CHECK_JOBSAcción

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.

Parámetros de entrada

querystringObligatorio
The GraphQL query string to execute against the Fly.io GraphQL API. Use the checkJobs query to retrieve check jobs. The query returns a CheckJobConnection with nodes, edges, pageInfo, and totalCount fields. Available fields on CheckJob include: id, httpOptions, locations, nextRunAt, runs, schedule, and url. Supports pagination with after, before, first, and last parameters.
variablesobject
Optional variables for the GraphQL query. Use for parameterized queries. For pagination, you can provide: first (Int), last (Int), after (String cursor), before (String cursor). Example: {'first': 10, 'after': 'cursor_value'}

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Check User Only TokenFLY_CHECK_USER_ONLY_TOKENAcción

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

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Health Check JobFLY_CREATE_CHECK_JOBAcción

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.

Parámetros de entrada

urlstringObligatorio
The URL endpoint to monitor for health checks. This should be a fully qualified URL that will be checked from multiple locations.
locationsstring[]Obligatorio
List of geographic locations from which to perform health checks. Common locations include 'newyork', 'london', 'tokyo', 'sydney', 'singapore', etc.
http_optionsobjectObligatorio
HTTP configuration options for the health check, including the HTTP verb (GET/HEAD) and optional headers.
organization_idstringObligatorio
Organization ID where the health check job will be created. This should be your Fly.io organization identifier.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Check Job RunFLY_CREATE_CHECK_JOB_RUNAcción

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.

Parámetros de entrada

check_job_idstringObligatorio
The ID of the check job to trigger a run for. This is the unique identifier of an existing health check job.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Delegated WireGuard TokenFLY_CREATE_DELEGATED_WIRE_GUARD_TOKENAcción

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.

Parámetros de entrada

namestring
The name with which to refer to the peer. Optional field for identifying the token.
organization_idstringObligatorio
The node ID of the organization. This is the unique identifier for the Fly.io organization where the token will be created.
client_mutation_idstring
A unique identifier for the client performing the mutation. Optional field for tracking purposes.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Third-Party ConfigurationFLY_CREATE_THIRD_PARTY_CONFIGURATIONAcción

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.

Parámetros de entrada

namestringObligatorio
Friendly name for the configuration
caveatsstring
Base64 messagepack encoded macaroon caveats for additional restrictions
locationstringObligatorio
Location URL of the third-party service capable of discharging
uiexLevelstringObligatorioenum
Third-party caveat level for UI session tokens
DISABLEDOPT_INMEMBER_OPT_OUTADMIN_OPT_OUTREQUIRED
customLevelstringObligatorioenum
Third-party caveat level for custom token creation
DISABLEDOPT_INMEMBER_OPT_OUTADMIN_OPT_OUTREQUIRED
flyctlLevelstringObligatorioenum
Third-party caveat level for flyctl session tokens
DISABLEDOPT_INMEMBER_OPT_OUTADMIN_OPT_OUTREQUIRED
organizationIdstringObligatorio
The organization's node ID
clientMutationIdstring
A unique identifier for the client performing the mutation

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Delegated WireGuard TokenFLY_DELETE_DELEGATED_WIRE_GUARD_TOKENAcción

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.

Parámetros de entrada

namestring
The name with which to refer to the token. Either this or token must be provided to identify which token to delete.
tokenstring
The raw WireGuard token to delete. Either this or name must be provided to identify which token to delete.
organization_idstringObligatorio
The node ID of the organization. This is the unique identifier for the Fly.io organization that owns the token.
client_mutation_idstring
A unique identifier for the client performing the mutation. Optional field for tracking purposes.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete OrganizationFLY_DELETE_ORGANIZATIONAcción

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.

Parámetros de entrada

organizationIdstringObligatorio
The identifier of the organization to delete. This will permanently remove the organization and all associated resources.
clientMutationIdstring
A unique identifier for the client performing the mutation. Used for tracking and idempotency.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Remote BuilderFLY_DELETE_REMOTE_BUILDERAcción

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.

Parámetros de entrada

organization_idstringObligatorio
The node ID of the organization whose remote builder configuration should be deleted
client_mutation_idstring
A unique identifier for the client performing the mutation

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Third Party ConfigurationFLY_DELETE_THIRD_PARTY_CONFIGURATIONAcción

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.

Parámetros de entrada

client_mutation_idstring
A unique identifier for the client performing the mutation. Optional field for tracking purposes.
third_party_configuration_idstringObligatorio
The node ID of the third-party configuration to delete. This is the unique identifier for the third-party service configuration.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Detach Postgres ClusterFLY_DETACH_POSTGRES_CLUSTERAcción

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.

Parámetros de entrada

app_idstringObligatorio
The application ID to detach the Postgres cluster from. This is the target application that currently has Postgres attached.
client_mutation_idstring
A unique identifier for the client performing the mutation. Used for tracking and idempotency.
postgres_cluster_app_idstringObligatorio
The Postgres cluster application ID to detach. This is the ID of the Postgres database application.
postgres_cluster_attachment_idstring
The Postgres attachment ID. Optional identifier for the specific attachment to remove.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Establish SSH KeyFLY_ESTABLISH_SSH_KEYAcción

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

Parámetros de entrada

overrideboolean
Establish a key even if one is already set. Set to true to replace an existing SSH key.
organization_idstringObligatorio
The node ID of the organization to establish the SSH key for
client_mutation_idstring
A unique identifier for the client performing the mutation

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Fetch Nodes by IDsFLY_FETCH_NODES_BY_IDSAcción

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.

Parámetros de entrada

idsstring[]Obligatorio
A non-empty list of node IDs to fetch. Each ID should be a valid node identifier in the Fly.io system (e.g., organization IDs, app IDs, machine IDs). The query will return node objects for all valid IDs provided.
query_fieldsstring
Optional GraphQL fragment to specify which fields to return for each node type. If not provided, returns only id and __typename. Example: '... on Organization { name slug } ... on App { name status }'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Add-OnFLY_GET_ADD_ONAcción

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.

Parámetros de entrada

idstring
The ID of the add-on to find. Provide either id, name, or both to identify the add-on.
namestring
The name of the add-on to find. Provide either id, name, or both to identify the add-on.
providerstring
The provider of the add-on (optional filter). Common providers include 'upstash', 'tigris', etc.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Add-On ProviderFLY_GET_ADD_ON_PROVIDERAcción

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.

Parámetros de entrada

namestringObligatorio
The name of the add-on provider to query (e.g., 'tigris', 'sentry', 'arcjet', 'mysql', 'supabase', 'upstash_vector', 'wafris', 'upstash_redis')

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get app detailsFLY_GET_APP_DETAILSAcción

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

Parámetros de entrada

namestringObligatorio
The application name or ID to retrieve details for.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get CertificateFLY_GET_CERTIFICATEAcción

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.

Parámetros de entrada

certificate_idstringObligatorio
The unique identifier of the certificate to retrieve. This is the certificate ID in Fly.io system.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Current Token InfoFLY_GET_CURRENT_TOKEN_INFOAcción

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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Latest Image DetailsFLY_GET_LATEST_IMAGE_DETAILSAcción

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.

Parámetros de entrada

imagestringObligatorio
Image reference in repository/name:tag format (e.g., 'flyio/postgres:15' or 'registry.fly.io/myapp:latest'). Use images from Fly.io's registry for best results.
fly_versionstring
Fly version to use for tag resolution. Optional parameter to specify a particular Fly.io version for resolving the image tag.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Latest Image TagFLY_GET_LATEST_IMAGE_TAGAcción

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.

Parámetros de entrada

repositorystringObligatorio
The Docker image repository name (e.g., 'flyio/postgres', 'flyio/hellofly'). This should be the full repository path.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get MachineFLY_GET_MACHINEAcción

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

Parámetros de entrada

machineIdstringObligatorio
The unique identifier of the machine to retrieve.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Nearest RegionFLY_GET_NEAREST_REGIONAcción

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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Node by IDFLY_GET_NODEAcción

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.

Parámetros de entrada

idstringObligatorio
The globally unique ID of the object to fetch. This ID uniquely identifies any object in the Fly.io system (e.g., Organization, App, Machine, Volume, etc.).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get OrganizationFLY_GET_ORGANIZATIONAcción

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.

Parámetros de entrada

slugstringObligatorio
The organization slug to look up. This is a human-readable identifier for the Fly.io organization (e.g., 'personal', 'my-org').

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Personal OrganizationFLY_GET_PERSONAL_ORGANIZATIONAcción

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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get PlacementsFLY_GET_PLACEMENTSAcción

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.

Parámetros de entrada

countinteger
Number of machines to simulate placement. Defaults to 0, which returns the org-specific limit for each region.
regionstring
Region expression for placement as a comma-delimited set of regions or aliases. Defaults to '[region],any', to prefer the API endpoint's local region with any other region as fallback.
computeobject
Resource requirements for the Machine to simulate.
weightsobject
Optional weights to override default placement preferences. Higher values indicate stronger preference.
org_slugstringObligatorio
Organization slug identifier (e.g., 'personal' for personal account or your org name).
volume_namestring
Name of an existing volume to consider in placement.
volume_size_bytesinteger
Size of volume in bytes to consider in placement.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Platform InformationFLY_GET_PLATFORM_INFOAcción

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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Products and PricingFLY_GET_PRODUCTSAcción

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

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get RegionsFLY_GET_REGIONSAcción

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.

Parámetros de entrada

cpusinteger
Guest CPU count. Filter regions by CPU count availability.
gpusinteger
Guest GPU count. Filter regions by GPU availability.
sizestring
Guest machine size preset. Default is performance-1x. Use this to filter regions by machine size availability.
cpu_kindstring
Guest CPU kind (e.g., 'shared', 'performance'). Filter regions by CPU type availability.
gpu_kindstring
Guest GPU kind (e.g., 'a100-pcie-40gb', 'a100-sxm4-80gb'). Filter regions by GPU type availability.
memory_mbinteger
Guest memory in megabytes. Filter regions by memory availability.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Viewer InfoFLY_GET_VIEWER_INFOAcción

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.

Parámetros de entrada

querystring
GraphQL query string to retrieve viewer information. Default query fetches avatarUrl, createdAt, email, and featureFlags.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Issue CertificateFLY_ISSUE_CERTIFICATEAcción

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.

Parámetros de entrada

app_namesstring[]
The names of the apps this certificate will be limited to accessing
principalsstring[]
SSH principals for certificate (e.g. ['fly', 'root'])
public_keystring
The openssh-formatted ED25519 public key to issue the certificate for
valid_hoursinteger
Hours for which certificate will be valid
organization_idstringObligatorio
The node ID of the organization
client_mutation_idstring
Standard mutation identifier

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Add-On PlansFLY_LIST_ADD_ON_PLANSAcción

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.

Parámetros de entrada

lastinteger
Number of items to return from the end. Cannot be used with 'first'.
afterstring
Cursor for forward pagination. Returns items after this cursor.
firstinteger
Number of items to return from the beginning. Cannot be used with 'last'.
beforestring
Cursor for backward pagination. Returns items before this cursor.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Add-OnsFLY_LIST_ADD_ONSAcción

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.

Parámetros de entrada

querystring
GraphQL query string to retrieve add-ons. Default query fetches add-ons for all apps in the personal organization. You can customize the query to fetch specific fields from the AddOn type (id, name, status, createdAt, updatedAt, addOnPlanName, hostname, publicUrl, environment, metadata, options, etc.) or filter by organization.
variablesobject
Variables for the GraphQL query (optional). Use this to pass dynamic values like organization slugs, pagination parameters (first, after, before, last), or filters (type: AddOnType).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List AppsFLY_LIST_APPSAcción

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

Parámetros de entrada

app_rolestring
Filter apps by role
org_slugstringObligatorio
The organization slug, or 'personal', to filter apps

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Apps via GraphQLFLY_LIST_APPS_GRAPHQLAcción

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.

Parámetros de entrada

include_vmsboolean
Include VM count information for each app
include_volumesboolean
Include volume information for each app
include_servicesboolean
Include service information for each app

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Check LocationsFLY_LIST_CHECK_LOCATIONSAcción

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.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List MachinesFLY_LIST_MACHINESAcción

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.

Parámetros de entrada

lastinteger
Returns the last n machines (backward pagination). Cannot be used with 'first'.
afterstring
Cursor for forward pagination - returns machines after this cursor. Use with 'first'.
firstinteger
Returns the first n machines (forward pagination). Cannot be used with 'last'.
beforestring
Cursor for backward pagination - returns machines before this cursor. Use with 'last'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Organization MachinesFLY_LIST_ORG_MACHINESAcción

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.

Parámetros de entrada

limitinteger
The number of machines to fetch (max of 1000). If omitted, this is set to 500 by default
statestring
Comma separated list of states to filter. Valid states: created, started, stopped, suspended
cursorstring
Pagination cursor from previous response (takes precedence over updated_after)
regionstring
Filter machines by region
org_slugstringObligatorio
Fly Organization Slug
updated_afterstring
Only return machines updated after this time. Timestamp must be in the RFC 3339 format
include_deletedboolean
Include deleted machines in the response

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Remove WireGuard PeerFLY_REMOVE_WIRE_GUARD_PEERAcción

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.

Parámetros de entrada

namestringObligatorio
The name of the WireGuard peer to remove
organization_idstringObligatorio
The node ID of the organization to remove the WireGuard peer from

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Set Apps V2 DefaultFLY_SET_APPS_V2_DEFAULT_ONAcción

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.

Parámetros de entrada

default_onbooleanObligatorio
Whether or not new apps in this org use Apps V2 by default
organization_slugstringObligatorio
The slug of the organization to configure

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Third-Party ConfigurationFLY_UPDATE_THIRD_PARTY_CONFIGURATIONAcción

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.

Parámetros de entrada

namestring
Friendly name for this configuration
caveatsstring
Base64 messagepack encoded macaroon caveats for additional restrictions
locationstring
Location URL of the third-party service capable of discharging
uiexLevelstringenum
Authorization level for third-party caveat configuration.
DISABLEDOPT_INMEMBER_OPT_OUTADMIN_OPT_OUTREQUIRED
customLevelstringenum
Authorization level for third-party caveat configuration.
DISABLEDOPT_INMEMBER_OPT_OUTADMIN_OPT_OUTREQUIRED
flyctlLevelstringenum
Authorization level for third-party caveat configuration.
DISABLEDOPT_INMEMBER_OPT_OUTADMIN_OPT_OUTREQUIRED
clientMutationIdstring
A unique identifier for the client performing the mutation
thirdPartyConfigurationIdstringObligatorio
The node ID of the configuration to update

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Validate ConfigFLY_VALIDATE_CONFIGAcción

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.

Parámetros de entrada

definitionobjectObligatorio
A JSON object representing the fly.toml configuration to validate. Can be an empty object {} or contain fly.toml configuration fields like app, build, env, services, etc.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Validate WireGuard PeersFLY_VALIDATE_WIRE_GUARD_PEERSAcción

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.

Parámetros de entrada

peer_ipsstring[]Obligatorio
Array of WireGuard peer IP addresses to validate. These are typically IPv6 addresses in the fdaa: range used by Fly.io's internal network.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not