Start an analysis
Create one analysis run. Async - poll with GET /api/agent/analyses/. scanType is required and explicit: “starter” costs nothing, “deep” consumes paid account quota. clientRunId is your idempotency key: re-POSTing the same value replays the existing run.
Authorizations
Your API key (prv_...), sent as-is. It is the only credential the API needs - see the Authentication guide.
Body
Caller-chosen idempotency id. Reusing it replays the existing run.
"starter" costs nothing; "deep" runs the full paid analysis and consumes account quota. "free" is accepted as a legacy alias of "starter".
starter, deep The startup idea, in plain language.
ISO country code, e.g. "US" or "FR".
Where the founder is today. Canonical values: idea, validation, mvp, launched, growth, scaling (free text tolerated). Optional here, but the MCP tools require it for deep scans; it feeds the feasibility analysis.
Budget available to pursue the idea. Canonical values: bootstrap (no outside money), 10k, 50k, 100k, 100kPlus (over $100k), 1mPlus (over $1M); free text tolerated. Optional here, but the MCP tools require it for deep scans; it feeds the feasibility analysis.
"core" also generates the export-required sections; "none" returns the raw completion only.
core, none When true, creates a public share URL for the report.
Response
Run created (or replayed via clientRunId).
Your request type. Reliable from creation, even while PROCESSING.
starter, deep quick, deep_dive Derived from the report. Deep runs read "basic" until deep sections land.
basic, advanced PENDING, PROCESSING, COMPLETED, FAILED Per-module statuses. Deep reports only; null on free runs.