Runs
One vault, many runs.
Submit multiple questions independently into the active workspace. Each run has its own tier, price, progress, cancellation and retry state; evidence accumulates in the same vault.
Pass project_id to file a run under a project: it then reuses what earlier
runs in that project read. A run with no project reuses nothing from the vault
unless vault.reuse_scope is workspace; it still writes its sources to the
vault, and filing it later with PATCH /v1/runs/{id} moves them into the project.
- Batch: use a unique idempotency key for each immutable question and settings payload.
- Refine:
POST /v1/runs/{id}/rerun-fromcreates another billed run. Review its question, tier and price first. - Blocked: resolve the named escalation or upload the requested file, then resume.
Current run prices are Light $9 and Deep $49. The API fixes the price on each created run; an eligible trial run returns zero.
Further reading
Section titled “Further reading”- How it works: the pipeline a run goes through, step by step.
- What a run can read: the sources a run searches and the ones it will not.
- Pricing: Light and Deep, flat per run.