Stage a scan for human launch
Use this operation to hand a configured pentest to a human for launch. This operation does not launch a scan or reserve credits. First set up verified domains, connected repositories, saved test users, domain scan headers, uploads, and knowledge resources. Use create_test_user for test accounts and create_domain_scan_header for saved headers. The credentials and headers arrays must be absent or empty. Inline secrets are not accepted. Configure the targets and context with the same fields as createScan. Give the user launch_url from the response. That link opens Review & Launch in the dashboard. The human reviews the configuration and clicks Launch. A draft that this operation creates expires after seven days. Launch checks current access, targets, and billing again.
Authorizations
API token obtained from the Tokens endpoint or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.
Body
At least one target (domain_ids, repository_ids, upload_ids, or internal_targets) should be provided.
Cloud connections this run may read. If you omit this field, the run uses the connections that apply to its targets. A connection with empty applies_to_domain_ids and applies_to_repository_ids applies to every run. A connection with values in those lists applies only to a run that targets one of the listed domains or repositories. Send an empty array for no cloud connections.
Self-hosted only: stop the pentest gracefully once total LLM spend reaches this amount (USD). Omit for no limit. Spend is counted from the model config's Pricing when it is set. Otherwise it uses the cost the provider reports, or the LiteLLM price table.
x <= 1000000Self-hosted only: what happens when max_budget_usd is reached. pause parks every agent before its next model call until an operator resumes the scan with a higher limit or stops it (see POST /scans/{scanId}/budget); a paused scan waits with no deadline. stop ends the run at the limit. Defaults to pause. Ignored without max_budget_usd.
stop, pause