Skip to main content

​
List pentests

Get pentests with optional filters and pagination.
By default, the list does not include per-finding retest scans. To include them, pass include_retests=true. Required scope: scans:read

​
Start a new pentest

Provide domain_ids for blackbox pentests or repository_ids for whitebox pentests.
Required scope: scans:write

​
Pentest depth

The optional scan_tier field sets the pentest depth. The depth controls how deep the pentest goes and which model quality it uses:
  • lite — the full standard methodology at the lowest price (×0.3 credits).
  • standard — balanced testing at a lower price (×0.75 credits).
  • ultra — the deepest pentest and the default (×1, the standard price).
The multiplier applies to the pentest’s credit price. The field is not applicable on self-hosted deployments, for organizations with raw model selection, and for organizations on the Enterprise plan.

​
Get pentest detail

Required scope: scans:read

​
Rerun a pentest

Run a previous pentest configuration again:
Required scope: scans:write

​
Cancel a pentest

Cancel a pending or running pentest:
Required scope: scans:write

​
Download report

Download the PDF report for a completed pentest:
Required scope: scans:read

​
Retest findings

List the retests recorded for a pentest:
Required scope: scans:read Run validation again for each finding in a pentest:
Required scope: scans:write

​
Get a reusable template

Get the configuration of a pentest as a template. You can use the template to start new pentests:
Required scope: scans:read

​
Delete a pentest

Required scope: scans:write