Typed Fly.io Machines API Adapter

Overview

Fly.io publishes a REST API and OpenAPI reference; this workflow does not claim a provider-maintained JavaScript SDK. Generate or handwrite only a thin local adapter, keep provider fields visible, and centralize authentication, timeouts, limits, state waits, and redaction.

Prerequisites

• Chosen operations and current OpenAPI or endpoint documentation
• Runtime and HTTP client policy, schema generator decision, and error model
• Synthetic fixtures plus an authorized non-production app for contract verification

Instructions

Step 1: Freeze the contract

Record base URL, operation paths, request and response schemas, state enums, response codes, and retrieval fingerprint. Preserve unknown fields for forward compatibility.

Step 2: Define a thin transport