RequestNewProjectRetest

This method can be used for the following functionality: Request a new retest for a project that user has access to.

Parameters

The following URL, Headers and Parameters are required for requests to this API endpoint. Where a parameter is optional, it will be indicated. Otherwise treat all parameters as mandatory.

Headers

POST /api/ss/project/:id/retest/request HTTP/1.1
Host: demo.attackforge.com
X-SSAPI-KEY: APIKey
Content-Type: application/json
Connection: close

Parameters

id (string)

Id of the project.

Example:

POST /api/ss/project/5e7c29afa3362408cf502a11/retest/request HTTP/1.1

retesting_window_start (string)

Start date for retest window. Must be ISO8601 datetime e.g. 2025-03-23T00:00:00.000Z.

Example:

{   
    "retesting_window_start": "2025-03-23T00:00:00.000Z"
}

retesting_window_end (string) (optional)

End date for retest window. Must be ISO8601 datetime e.g. 2025-03-30T00:00:00.000Z.

Example:

{   
    "retesting_window_end": "2025-03-30T00:00:00.000Z"
}

vulnerability_ids (array of strings)

Project Vulnerability Ids to include in-scope for the retest round. Vulnerabilities must be in 'Retest' status.

Example:

{   
    "vulnerability_ids": ["6639508f50523053f459d29f"]
}

Example

The following example is a cURL request to request a retest round on a project.

Request

Include API Token instead of stars in 'X-SSAPI-KEY: ***************************************' parameter.

curl --request POST \
	--url https://demo.attackforge.com/api/ss/project/66333e1d110ab5acf8a4354e/retest/request \
	--header 'content-type: application/json' \
	--header 'x-ssapi-key: ***************************************' \
	--data '{
   "retesting_window_start": "2025-03-23T00:00:00.000Z",
   "retesting_window_end": "2025-03-30T00:00:00.000Z",
   "vulnerability_ids": ["6639508f50523053f459d29f"]
}'

Response

Response contains a status.

{
   "status": "Project retest requested for Project 66333e1d110ab5acf8a4354e"
}