ESescape
ContinuousScans
Beta

Start a continuous pentest run

Start a CONTINUOUS_PENTEST on a profile that already has continuous pentest enabled. The returned id is the scan id. Use POST /scans for a full AI pentest on the same profile.

post/continuous-scans

Request

  • Base URL
    https://public.escape.tech/v3
  • Auth
    API key in header X-ESCAPE-API-KEY

Request body

profileIdstring uuid required

The AI pentest profile with continuous set up

commitHashstring

Indicative commit SHA stored as a tag on the scan. Does not change continuous behavior.

initiator'CI' | 'MERGE' | 'MANUAL' | 'SCHEDULED' | 'null' nullable

Who started the continuous run. Defaults to CI.

Example request

{
  "profileId": "00000000-0000-0000-0000-000000000000",
  "commitHash": "abc123",
  "continuous": {
    "commitHash": "def456",
    "repositoryUrl": "https://github.com/org/repo"
  }
}

Response

OK

idstring uuid required

The id of the scan

statusstring required

The status of the scan

createdAtstring required

The date and time the scan was created

updatedAtstring required

The date and time the scan was updated

finishedAtstring nullable required

The date and time the scan was finished

scorenumber nullable required

The score of the scan

coveragenumber nullable required

Aggregate API coverage ratio for this scan (0–1), when the scan has finished with coverage data

durationnumber required

The duration of the scan

progressRationumber required

The progress ratio of the scan

initiatorstring required

The initiator of the scan

kindstring required

The kind of the scan

profileIdstring required

The id of the profile of the scan

organizationIdstring required

The id of the organization of the scan

commitHashstring nullable required
commitBranchstring nullable required
commitAuthorstring nullable required
commitLinkstring nullable required
commitAuthorProfilePictureLinkstring nullable required
ignoredboolean

Whether the scan is ignored. Only returned by the scan detail endpoint.

executiveSummarystring nullable

AI-generated executive summary of the scan. Credentials and secrets are redacted. Only returned by the scan detail endpoint.

scopeSummarystring nullable

AI-generated summary of the scanned scope. Credentials and secrets are redacted. Only returned by the scan detail endpoint.

Changes

No recorded changes to this operation across all 1 revision of this API.