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.
No operations match.
See How connections work for access and permissions, or browse all integrations.