Preflight a source
Check a database before connecting it — creates nothing
200 — read preflight_pass in the response. When grants are the problem, grant_script holds ready-to-run SQL that fixes them.Authorizations
Ardent API key (sk-ard_live_… / sk-ard_test_…) or a dashboard session token.
Body
Connection details for the source database. Nothing is stored.
Service type. postgresql is the only supported value today.
Allow customer-cloud placement far from the worker region.
Database to render in the grant script. Affects only grant_script.
Customer-cloud environment; required when your org has more than one.
Organization to preflight for. Inferred from your auth when omitted.
Private connection for the source database; needs use_environment.
Schemas to render in the grant script. Affects only grant_script.
Route preflight through a customer-cloud environment.
Response
The full preflight report. A failed gate is still a 200 — read preflight_pass.
True when the checks required for branching pass.
Individual check results, keyed by check name.
Ready-to-run SQL grant script for the source database.
True when every preflight check passes.
Metadata gathered from the source during preflight.
Detected source provider, for example supabase or vanilla.