ESescape
Retests
Beta

Start a retest

Start an issue retest on a DAST or AI pentest profile. Provide either issueIds or filter, not both. The returned id is the scan id.

post/retests

Request

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

Request body

profileIdstring uuid required

The profile ID to retest

issueIdsstring[]

Explicit issue IDs to retest. Provide this or filter, not both.

contextstring

Optional operator context for the retest agents

initiator'CI' | 'MANUAL' | 'SCHEDULED'

The initiator of the retest

Example request

{
  "profileId": "00000000-0000-0000-0000-000000000000",
  "issueIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "context": "Verify the auth bypass fix on checkout.",
  "initiator": "MANUAL"
}

Response

OK

idstring uuid required

The scan ID of the retest

profileIdstring required

The profile the retest ran on

statusstring required

The scan status of the retest

progressRationumber required

The progress ratio of the retest scan

createdAtstring required

The date and time the retest was created

finishedAtstring nullable required

The date and time the retest finished

contextstring nullable required

Optional operator context passed when starting the retest

Changes

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