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"
}