Create a draft automation
name becomes the public /v1/run/:flow endpoint, so it is validated server-side as a URL-safe slug (^[a-z0-9][a-z0-9-]*$, max 64) unique per org. site is REQUIRED — the Build studio has nowhere to record against otherwise. Optional params pre-declares typed parameters, seeding an authoring session so the Build studio opens with them already configured.
承認
The dashboard's signed, HttpOnly session cookie (packages/service/src/auth.ts): base64url(payload).base64url(hmac-sha256), absolute 30-day lifetime, SameSite=Lax, Secure on any TLS deployment. Minted by POST /api/auth/signup or POST /api/auth/login (or, outside production, auto-provisioned by GET /api/session). Because it is HttpOnly, it cannot be read or attached by a browser-based API-reference "Try it" panel across origins — exercise these routes with a real logged-in browser session or a cookie-jar HTTP client.
ボディ
レスポンス
The draft automation.
The product's core object — an Automation (the engine's Flow). name is the public /v1/run/:flow endpoint and unique per org. status gates running: draft (never runnable), published (live), failing (a locator drift was detected — see needs_attention/rerecord_href).