Skip to main content

AI Pentest

Autonomous AI penetration testing scans and reports.

πŸ“„οΈ Trigger Pentest Scan

Start the pentest scan workflow after validating that a target URL is set, the tenant's plan includes the AI Pentest feature (403 otherwise), and the target URL's host is covered by a verified domain or an app-scoped verification (422 otherwise; the ownership check is skipped when OWNERSHIP_VERIFICATION_ENABLED is false). A mobile target (target_kind android-apk or ios-repo) has no host: it needs at least one verified domain or app and every declared allowed domain verified, and that check is NEVER skipped, whatever OWNERSHIP_VERIFICATION_ENABLED says. Returns 404 when not found and 409 when the pentest is already pending or running.

πŸ“„οΈ Stop Running Pentest Early (Keep Report)

Ask the engine to finish a running pentest now with what it has found. The run stays running while the engine wraps up; its findings and report then arrive as on a normal completion and the pentest ends completed with `stopped_early: true`. Returns 404 when the pentest does not exist, 409 when it is not running or a stop is already pending, 409 `engine_cannot_stop` when the engine does not support finishing early (nothing is changed), and 502 when the engine cannot be reached. Cancel stays the hard abort.

πŸ“„οΈ Retest A Completed Pentest

Re-run the confirmed findings of a completed pentest against the same target and report one verdict per finding (fixed, fixed_by_removal, not_fixed, env_changed, not_retestable). One retest is included with each pentest, within 90 days of its completion; it creates no findings and uses no AI credits. The target ownership check runs again on every launch. `mutating_replays_acknowledged` (administrators only) lets replays that change target state run. Refusals are problem+json with a stable `data.code`: pentest_not_found (404); pentest_not_completed, retest_window_closed, retest_in_progress (409); retest_not_included, mutating_ack_requires_admin (403); target_ownership_unverified, target_scope_unrecorded, no_retestable_findings, manifest_too_large (422); artifact_store_unavailable (503); retest_launch_failed (500).

πŸ“„οΈ List The Retests Of A Pentest

Return the retests of a pentest, newest first (at most 20): `retest_id`, `seq`, `status` (pending, running, completed, failed, refused, cancelled), `phase` (queued, starting, verifying, or the terminal status), `target_url`, `coverage`, the `created_at`/`started_at`/`finished_at` times, `entitlement_refunded`, and for a failed retest `failure` with a closed `code` (target_unreachable, engine_unavailable, login_not_applied, request_rejected, timed_out, engine_error, cancelled) and a `message`. Refusal is problem+json with `data.code`: pentest_not_found (404).

πŸ“„οΈ Get One Retest

Return one retest of a pentest: everything the list returns plus `verdict_summary` (counts by verdict), `verdicts` (`finding_id`, `verdict`, `reason`, `row`, `fixed_subclass`), `not_run` (finding ids), `refused` and `control` when the engine could not log in fresh, and `cap_remaining_seconds` (seconds before an active retest is stopped; null when it is not running). Evidence is never returned. Refusal is problem+json with `data.code`: retest_not_found (404), also for a retest of another pentest or tenant.

πŸ“„οΈ Get Pentest Chain Of Proof

Return the chain of proof of a pentest as one linear ribbon (entry, steps, objective) with the proofs no path links in `aside`, read from the engine's `chain.json`. A step is `linked` or `blocked`; its connector to the previous step is `solid` (replay-verified), `dashed` or `none`. After a retest, a step is `fixed` only when EVERY finding on it has the retest verdict `fixed` (`fixed_by_removal` never marks a step). A pentest with no published chain answers 200 with `available: false` and a `reason` (`not_published`, `unsupported_schema`, `invalid`), never an invented chain. Replays are read through the existing finding replay download; nothing here runs them. Returns 404 when the pentest does not exist and 503 when object storage is unreachable.