Skip to content
Changelog

Report a bug

Fly integration: operations for AI agents

Fly connects to Type.com as an integration. This page lists the 100 operations documented for Claude and Codex in Type.com: 38 read, 43 write, 19 destructive.

About Fly

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

Categories: Developer Tools & IT

How to connect Fly to Type.com

Access
Organization connection: one shared account for the workspace.

To add the connection, follow the steps in Space connections.

Documented operations

100 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

100 operations listed.

Apps

  • Read

    List Apps

    List all apps with the ability to filter by organization slug.

  • Read

    Get App

    Retrieve details about a specific app by its name.

  • Read

    List IP assignments for app

    GET /v1/apps/{app_name}/ip_assignments

  • Write

    Create App

    Create an app with the specified details in the request body.

  • Write

    Create App deploy token

    POST /v1/apps/{app_name}/deploy_token

  • Write

    Assign new IP address to app

    POST /v1/apps/{app_name}/ip_assignments

  • Destructive

    Destroy App

    Delete an app by its name.

  • Destructive

    Remove IP assignment from app

    DELETE /v1/apps/{app_name}/ip_assignments/{ip}

TLS Certificates

  • Read

    List certificates for app

    GET /v1/apps/{app_name}/certificates

  • Read

    Get certificate details

    GET /v1/apps/{app_name}/certificates/{hostname}

  • Read

    Check DNS and re-validate certificate

    POST /v1/apps/{app_name}/certificates/{hostname}/check

  • Write

    Request ACME certificate

    POST /v1/apps/{app_name}/certificates/acme

  • Write

    Upload custom certificate

    POST /v1/apps/{app_name}/certificates/custom

  • Destructive

    Remove certificate

    DELETE /v1/apps/{app_name}/certificates/{hostname}

  • Destructive

    Remove ACME certificates

    DELETE /v1/apps/{app_name}/certificates/{hostname}/acme

  • Destructive

    Remove custom certificate

    DELETE /v1/apps/{app_name}/certificates/{hostname}/custom

Machines

  • Read

    List Machines

    List all Machines associated with a specific app, with optional filters for including deleted Machines and filtering by region.

  • Read

    Get Machine

    Get details of a specific Machine within an app by the Machine ID.

  • Read

    List Events

    List all events associated with a specific Machine within an app.

  • Read

    Get Lease

    Retrieve the current lease of a specific Machine within an app. Machine leases can be used to obtain an exclusive lock on modifying a Machine.

  • Read

    Get Machine Memory

    Get current memory limit and available capacity for a machine

  • Read

    Get Metadata

    Retrieve metadata for a specific Machine within an app.

  • Read

    Get Metadata Value

    Get the value of a specific metadata key

  • Read

    List Processes

    List all processes running on a specific Machine within an app, with optional sorting parameters.

  • Read

    List Versions

    List all versions of the configuration for a specific Machine within an app.

  • Read

    Wait for State

    Wait for a Machine to reach a specific state. Specify the desired state with the state parameter. See the Machine states table for a list of possible states. The default for this parameter is started. This request will block for up to 60 seconds.

  • Write

    Create Machine

    Create a Machine within a specific app using the details provided in the request body. Important: This request can fail, and you’re responsible for handling that failure.

  • Write

    Update Machine

    Update a Machine's configuration using the details provided in the request body.

  • Write

    Cordon Machine

    “Cordoning” a Machine refers to disabling its services, so the Fly Proxy won’t route requests to it.

  • Write

    Execute Command

    Execute a command on a specific Machine and return the raw command output bytes.

  • Write

    Create Lease

    Create a lease for a specific Machine within an app using the details provided in the request body. Machine leases can be used to obtain an exclusive lock on modifying a Machine.

  • Write

    Reclaim Machine Memory

    Trigger the balloon device to reclaim memory from a machine

  • Write

    Update Metadata (set/remove multiple keys)

    Update multiple metadata keys at once. Keys that are not in the request are left untouched. Null values and empty strings remove keys. + If machineversion is provided and no longer matches the current machine version, returns 412 Precondition Failed.

  • Write

    Upsert Metadata Key

    Update metadata for a specific machine within an app by providing a metadata key.

  • Write

    Restart Machine

    Restart a specific Machine within an app, with an optional timeout parameter.

  • Write

    Signal Machine

    Send a signal to a specific Machine within an app using the details provided in the request body.

  • Write

    Start Machine

    Start a specific Machine within an app.

  • Write

    Stop Machine

    Stop a specific Machine within an app, with an optional request body to specify signal and timeout.

  • Write

    Suspend Machine

    Suspend a specific Machine within an app. The next start operation will attempt (but is not guaranteed) to resume the Machine from a snapshot taken at suspension time, rather than performing a cold boot.

  • Write

    Uncordon Machine

    “Cordoning” a Machine refers to disabling its services, so the Fly Proxy won’t route requests to it.

  • Destructive

    Destroy Machine

    Delete a specific Machine within an app by Machine ID. Only a Machine in the stopped, suspended, failed, pending or archived state can be deleted.

  • Destructive

    Release Lease

    Release the lease of a specific Machine within an app. Machine leases can be used to obtain an exclusive lock on modifying a Machine.

  • Destructive

    Set Machine Memory Limit

    Set the memory limit for a machine using the balloon device

  • Destructive

    Delete Metadata

    Delete metadata for a specific Machine within an app by providing a metadata key.

Secrets

  • Read

    List secret keys belonging to an app

    GET /v1/apps/{app_name}/secretkeys

  • Read

    Get an app's secret key

    GET /v1/apps/{app_name}/secretkeys/{secret_name}

  • Read

    List app secrets belonging to an app

    GET /v1/apps/{app_name}/secrets

  • Read

    Get an app secret

    GET /v1/apps/{app_name}/secrets/{secret_name}

  • Write

    Create or update a secret key

    POST /v1/apps/{app_name}/secretkeys/{secret_name}

  • Write

    Decrypt with a secret key

    POST /v1/apps/{app_name}/secretkeys/{secret_name}/decrypt

  • Write

    Encrypt with a secret key

    POST /v1/apps/{app_name}/secretkeys/{secret_name}/encrypt

  • Write

    Generate a random secret key

    POST /v1/apps/{app_name}/secretkeys/{secret_name}/generate

  • Write

    Sign with a secret key

    POST /v1/apps/{app_name}/secretkeys/{secret_name}/sign

  • Write

    Verify with a secret key

    POST /v1/apps/{app_name}/secretkeys/{secret_name}/verify

  • Write

    Update app secrets belonging to an app

    Running Machines don't pick up the change on their own: create or update Machines with minsecretsversion set to the returned version for them to see it.

  • Write

    Create or update Secret

    Running Machines don't pick up the change on their own: create or update Machines with minsecretsversion set to the returned version for them to see it.

  • Destructive

    Delete an app's secret key

    DELETE /v1/apps/{app_name}/secretkeys/{secret_name}

  • Destructive

    Delete an app secret

    Running Machines don't pick up the change on their own: create or update Machines with minsecretsversion set to the returned version for them to see it.

Volumes

  • Read

    List Volumes

    List all volumes associated with a specific app.

  • Read

    Get Volume

    Retrieve details about a specific volume by its ID within an app.

  • Read

    List Snapshots

    List all snapshots for a specific volume within an app.

  • Write

    Create Volume

    Create a volume for a specific app using the details provided in the request body.

  • Write

    Create Snapshot

    Create a snapshot for a specific volume within an app.

  • Destructive

    Update Volume

    Update a volume's configuration using the details provided in the request body.

  • Destructive

    Destroy Volume

    Delete a specific volume within an app by volume ID.

  • Destructive

    Extend Volume

    Extend a volume's size within an app using the details provided in the request body.

Organizations

  • Read

    List All Machines

    List all Machines associated with a specific organization. Machines are sorted by their updatedat timestamps, oldest to newest. This API call represents "a point in time". Recent machine changes, including creations and destructions, may take time to propagate.

  • Read

    List All Volumes

    List all volumes for an organization with optional filters and cursor-based pagination.

Platform

  • Read

    Get Placements

    Simulates placing the specified number of machines into regions, depending on available capacity and limits.

  • Read

    Get Regions

    List all regions on the platform with their details.

Postgres Clusters

  • Read

    List Postgres Clusters

    List Managed Postgres clusters for an organization.

  • Read

    List Postgres Plans

    List the Managed Postgres plans the caller can choose when creating or forking a cluster in an organization, cheapest first.

  • Read

    Get Postgres Cluster

    Get details of a specific Managed Postgres cluster.

  • Read

    List Backups

    List all backups associated with a specific cluster.

  • Read

    List Databases

    List all databases within a specific cluster.

  • Read

    List Extensions

    List all extensions available within a specific database, indicating which are installed.

  • Read

    List Active Queries

    List active queries in the supplied database. The database query parameter is required and must not be empty or whitespace-only. Returns full query text and durations in seconds.

  • Read

    List Slow Queries

    List the top 20 queries by cumulative total execution time, excluding the postgres database. Uses the latest available metrics within the lookback range; statistics are cumulative PostgreSQL counters, not deltas over that range.

  • Read

    List Users

    List all Postgres users within a specific cluster.

  • Read

    Get User Credentials

    Get the connection credentials for a specific Postgres user within a cluster.

  • Write

    Create Postgres Cluster

    Create a Managed Postgres cluster for the organization named in the request body. Provisioning is asynchronous: poll GET /v1/postgres/{id} until status == ready before calling database, user, extension, or credential endpoints.

  • Write

    Attach Cluster to App

    Record an attachment between a cluster and a Fly app. This endpoint records the relationship but does not set DATABASEURL or other app secrets; configure the connection string separately. The attachment is created if it does not already exist.

  • Write

    Create Backup

    Create a backup for a specific cluster. The backup runs asynchronously and is rejected if one is already in progress.

  • Write

    Create Database

    Create a database within a specific cluster.

  • Write

    Enable Extension

    Enable a Postgres extension within a specific database. PostGIS extensions require a PostGIS-enabled cluster.

  • Write

    Fork Cluster to New Cluster

    Fork a ready Managed Postgres cluster into a new cluster that inherits the source's settings, on the source's plan unless plan is given. The source cluster is left unchanged, and the fork is provisioned asynchronously.

  • Write

    Restore Backup or Point in Time to New Cluster

    Restore a backup, or a point in time within the cluster's PITR recovery window, into a new Managed Postgres cluster. The source cluster is left unchanged, and a new cluster is provisioned asynchronously.

  • Write

    Create User

    Create a Postgres user within a specific cluster. Fetch the generated password from the credentials endpoint.

  • Write

    Update User Role

    Update a specific Postgres user's role within a cluster.

  • Write

    Rotate User Password

    Rotate a specific Postgres user's password within a cluster, optionally terminating the user's existing sessions.

  • Destructive

    Delete Postgres Cluster

    Delete a Managed Postgres cluster. The cluster is marked for deletion and removed asynchronously.

  • Destructive

    Detach Cluster from App

    Detach a specific cluster from a Fly app.

  • Destructive

    Drop Database

    Delete a specific database within a cluster, along with objects that depend on it.

  • Destructive

    Disable Extension

    Disable a specific Postgres extension within a database, optionally dropping objects that depend on it. System extensions cannot be disabled.

  • Destructive

    Delete User

    Delete a specific Postgres user within a cluster.

Tokens

  • Read

    Get Current Token Information

    Get information about the current macaroon token(s), including organizations, apps, user identity hashes, and machine restrictions

  • Write

    Authenticate token header

    Verify a token header without checking resource access.

  • Write

    Authorize token for resource access

    Verify a token header and validate it against a requested access scope.

  • Write

    Request a Petsem token for accessing KMS

    POST /v1/tokens/kms

  • Write

    Request an OIDC token

    Request an Open ID Connect token for your machine. Customize the audience claim with the aud parameter. This returns a JWT token. Learn more about using OpenID Connect on Fly.io.

See How connections work for access and permissions, or browse all integrations.