Create a List

Creates a new list of QIDs.

POST/csapi/v1.3/list

Input ParametersInput Parameters

Parameter Mandatory/Optional Data Type Description
name Mandatory string Specify a name for the list.
listType Mandatory string

Specify the type of list. 

Valid values: STATIC, and DYNAMIC.

dynamicFilter Mandatory string

Specify to filter QIDs using QQL tokens.

Valid values: 

cveIds cvssInfo.accessVector cvssInfo.baseScore
cvss3Info.baseScore cvssInfo.temporalScore cvss3Info.temporalScore
qid severity


For example, 
"dynamicFilter": "severity:2 AND cvssInfo.baseScore:5"

scope Mandatory string Specify the scope of the list. Currently, the only valid value is "VULNERABILITY".
qidsToBeAdded Mandatory string

Applicable only if the listType is "STATIC".

Specify the QIDs to be added to the list. If the QIDs are specified, the "qidsAdditionFilter" parameter is ignored.

qidsAdditionFilter Mandatory string

Applicable only if the listType is "STATIC".
Specify a filter query to select QIDs.

Sample: Create a New Vulnerability ListSample: Create a New Vulnerability List

API Request - For creating a Static list

curl -X "POST"
"<qualys_base_url>/csapi/v1.3/list"
-H "accept: application/json"
-H "Authorization: Bearer <token>"
-H "Content-Type: application/json"
-d "{
    "name": "pcbstatic_list",
    "listType": "STATIC",
    "scope": "VULNERABILITY",
    "qidsToBeAdded": [
        993395,
        754102,
        92012
    ],
    "qidsAdditionFilter": null;
}'

API Request - For creating a Dynamic list

curl -X "POST"
"<qualys_base_url>/csapi/v1.3/list"
-H "accept: application/json"
-H "Authorization: Bearer <token>"
-H "Content-Type: application/json"
-d "{
    "name": "test002_list",
    "listType": "DYNAMIC",
    "dynamicFilter": "severity:2",
    "scope": "VULNERABILITY"
}'

Response

{
    "listUuid": "43bcefbf-74cd-4d67-9b87-f3f4284d8cce"
}