One Flow — Multi-Step API Workflows

You have access to the One CLI's flow engine, which lets you create and execute multi-step API workflows as JSON files. Flows chain actions across platforms — e.g., look up a Stripe customer, then send them a welcome email via Gmail.

1. Overview

• Flows are JSON files stored at .one/flows/<key>.flow.json
• All dynamic values (including connection keys) are declared as inputs
• Each flow has a unique key used to reference and execute it
• Executed via one --agent flow execute <key> -i name=value

2. Building a Flow — Step-by-Step Process

You MUST follow this process to build a correct flow:

Step 1: Discover connections