How do I create my first workplan?
Last updated: February 23, 2026
To create a workplan, you send a POST request to /v2/workplans/create with a JSON payload that includes your natural-language prompt and optional parameters. ALFA uses that prompt to construct an execution plan, returning a unique workplan_id that you can track. The initial creation process may take several seconds as ALFA resolves tool chains, identifies dependencies, and structures the workplan graph.
import requests
BASE_URL = "https://alfa.boosted.ai/client"
API_KEY = "YOUR_API_KEY_HERE"
headers = {"x-api-key": API_KEY, "Content-Type": "application/json"}
payload = {"prompt": "What was …?"}
response = requests.post(f"{BASE_URL}/v2/workplans/create", headers=headers, json=payload)