Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

/rest/{version}/history/vulnerabilities/{vulnId}/history/objects?

Descriptor

Value

HTTP Method

POST

Description

Returns a list of history events for a given vulnerability.

Required Permission

Read Access

Version Introduced2.8.3


Request Header Parameters

Parameter

Value

Required

Description

Accept

String

Yes

A value of ‘application/json’ must be provided.

Request Get Parameters

Parameter

Value Type

Required

Description

page

Integer

No

Which page of vulnerability history events to return.

numberToShowIntegerNoHow many vulnerability history events to return.

Sample Calls: 


Code Block
themeEclipse
curl -H 'Accept: application/json' -H 'Authorization: APIKEY {apiKey}' http://localhost:8083/threadfix/rest/v283/history/vulnerabilities/16484/history/objects?numberToShow=25&page=1


Sample Output:


Code Block
themeEclipse
{
    "message": "",
    "success": true,
    "responseCode": -1,
    "object": {
        "retrievedHistory": true,
        "eventHistory": [
            {
                "id": 110,
                "date": 1597997707000,
                "eventAction": "VULNERABILITY_OPEN_SCAN_UPLOAD",
                "detail": null,
                "status": null,
                "groupCount": null,
                "description": "ThreadFix performed an action: Create Vulnerability From Scan Upload",
                "userName": "ThreadFix",
                "vulnerabilityId": 68,
                "applicationId": 1,
                "organizationId": null,
                "defectId": null,
                "vulnerabilityDescriptionWithUrls": {
                    "string": "ThreadFix created Vulnerability uploading a <a href='{URL_0}'>Scan</a> to Application.",
                    "{URL_0}": "/organizations/3/applications/1/scans/11",
                    "urlCount": 1
                },
                "vulnerabilityCommentId": null,
                "eventActionDisplayName": "Create Vulnerability From Scan Upload",
                "scanId": 11
            }
        ]
    }
}

...