Skip to main content

Overview

Buckle connects AI agents to Fly.io so they can deploy and manage applications, Machines, volumes, and secrets. The gateway injects your API token into requests automatically.

What you will set up

  • A Fly.io API token stored in Buckle
  • Automatic Bearer injection on requests to api.machines.dev and api.fly.io
  • Per-agent, per-tool access to apps and Machines

Setup

1

Create an API token

Generate a token from the Fly.io dashboard or run:
2

Connect in Buckle

Open the Buckle dashboard, go to Settings > Apps > Fly.io, and paste your API token.
Buckle connect window for Fly.io, showing the setup guide link and the fields to fill in.

The Fly.io connect window in Buckle.

How it works

  1. Your API token is encrypted and stored by Buckle
  2. When an agent sends a request to api.machines.dev or api.fly.io, the gateway intercepts it
  3. The gateway injects the token as an Authorization: Bearer header
  4. The request is forwarded to Fly.io
Agents never see the raw token.

What agents can do

Use cases

  • Coding agents deploying applications after building
  • Infrastructure agents scaling Machines up or down
  • Monitoring agents checking application health
  • Agents managing secrets and environment variables

Controlling access

Access is per agent: grant the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization rules add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches Fly.io.

FAQ

Create a new token with fly tokens create org or in the dashboard, then paste it into Settings > Apps > Fly.io. Agents pick up the new token automatically. Then revoke the old one.
Don’t set FLY_API_TOKEN in the agent’s environment. Store the token in Buckle, and the gateway injects it at the proxy. See How it works.
Yes. Set write tools to need approval when you grant the connection, or add rules.