Delete Scan Template

For API version information, refer to the API Version History section.

V2.0V3.0 | V4.0 | V7.0

Scan report template supports enhanced capabilities across versions:
- Kernel Live Patch (v5): Provides the ability to exclude Linux kernel CVEs that are already fixed by live patches, reducing false positives and improving visibility into truly actionable vulnerabilities.

- Deep Scan (v6): Discovers vulnerable software and binaries in non-standard locations that traditional scans may miss. This API allows Deep Scan findings to be included in scan report templates.

- CVSS v4.0 Support (v7): Uses enhanced vulnerability scoring for greater precision and context‑aware reporting in API‑driven workflows.

To enable features from earlier versions (v5 and v6) and the current version (v7), if CVSS v4 is not visible in your environment, contact your Technical Account Manager (TAM) or Qualys Support.

V2.0

POST /api/2.0/fo/report/template/scan/?action=delete

Delete a scan report template in the user's account.

Input ParametersInput Parameters

Parameter

Required/Optional

Data
Type

Description

action=delete

Required

String

Specify action=delete to delete the scan template.

template_id={value}

Required

Integer

The template ID you want to take action on.

Sample - Delete Scan TemplateSample - Delete Scan Template

API Request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With:curl" -d  "action=delete&template_id=8209""<qualys_base_url>/api/2.0/fo/report/template/scan/"

XML Output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE SIMPLE_RETURN SYSTEM "<qualys_base_url>/api/2.0/simple_return.dtd">
<SIMPLE_RETURN>
  <RESPONSE>
    <DATETIME>2017-04-04T10:54:37Z</DATETIME>
    <CODE>Scan Report Template(s) Deleted Successfully [8209]</CODE>
    <TEXT></TEXT>
  </RESPONSE>
</SIMPLE_RETURN>

DTD

<platform API server>/api/2.0/simple_return.dtd

V3.0

POST /api/3.0/fo/report/template/scan/?action=delete

Delete a scan report template in the user's account.

Input ParametersInput Parameters

Parameter

Required/Optional

Data
Type

Description

action=delete

Required

String

Specify action=delete to delete the scan template.

template_id={value}

Required

Integer

The template ID you want to take action on.

Sample - Delete Scan TemplateSample - Delete Scan Template

API Request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With:curl" -d  "action=delete&template_id=8209""<qualys_base_url>/api/3.0/fo/report/template/scan/"

XML Output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE SIMPLE_RETURN SYSTEM "<qualys_base_url>/api/3.0/simple_return.dtd">
<SIMPLE_RETURN>
  <RESPONSE>
    <DATETIME>2017-04-04T10:54:37Z</DATETIME>
    <CODE>Scan Report Template(s) Deleted Successfully [8209]</CODE>
    <TEXT></TEXT>
  </RESPONSE>
</SIMPLE_RETURN>

DTD

<platform API server>/api/3.0/simple_return.dtd

V4.0

POST /api/4.0/fo/report/template/scan/?action=delete

Delete a scan report template in the user's account.

Input ParametersInput Parameters

Parameter

Required/Optional

Data
Type

Description

action=delete

Required

String

Specify action=delete to delete the scan template.

template_id={value}

Required

Integer

The template ID you want to take action on.

 

Sample - Delete Scan TemplateSample - Delete Scan Template

API Request

curl --location '<qualys_base_url>/api/4.0/fo/report/template/scan/' \
--header 'X-Requested-With: curl' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic Encoded username:passwordstring' \
--data-urlencode 'template_id=8737800' \
--data-urlencode 'action=delete'

XML Output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE SIMPLE_RETURN SYSTEM "<qualys_base_url>/api/4.0/simple_return.dtd">
<SIMPLE_RETURN>
    <RESPONSE>
        <DATETIME>2025-06-17T10:58:30Z</DATETIME>
        <TEXT>Scan Report Template(s) Successfully Deleted.</TEXT>
        <ITEM_LIST>
            <ITEM>
                <KEY>ID</KEY>
                <VALUE>8737800</VALUE>
            </ITEM>
        </ITEM_LIST>
    </RESPONSE>
</SIMPLE_RETURN>

<platform API server>/api/4.0/simple_return.dtd

V7.0

POST /api/7.0/fo/report/template/scan/?action=delete

Delete a scan report template in the user's account.

Input ParametersInput Parameters

Parameter

Required/Optional

Data
Type

Description

action=delete

Required

String

Specify action=delete to delete the scan template.

template_id={value}

Required

Integer

The template ID you want to take action on.

Sample - Delete Scan TemplateSample - Delete Scan Template

API Request

curl --location '<qualys_base_url>/api/7.0/fo/report/template/scan/' \
--header 'X-Requested-With: curl' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic Encoded username:passwordstring' \
--data-urlencode 'template_id=8737800' \
--data-urlencode 'action=delete'

XML Output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE SIMPLE_RETURN SYSTEM "<qualys_base_url>/api/7.0/simple_return.dtd">
<SIMPLE_RETURN>
    <RESPONSE>
        <DATETIME>2025-06-17T10:58:30Z</DATETIME>
        <TEXT>Scan Report Template(s) Successfully Deleted.</TEXT>
        <ITEM_LIST>
            <ITEM>
                <KEY>ID</KEY>
                <VALUE>8737800</VALUE>
            </ITEM>
        </ITEM_LIST>
    </RESPONSE>
</SIMPLE_RETURN>

DTD

<platform API server>/api/7.0/simple_return.dtd

API Version History

The following table depicts the information about the different versions of this API along with the status:

API Version EOS EOL
/api/7.0/fo/report/template/scan/?action=delete Active Active
/api/4.0/fo/report/template/scan/?action=delete December 2026 June 2027
/api/3.0/fo/report/template/scan/?action=delete December 2025

June 2026

/api/2.0/fo/report/template/scan/?action=delete December 2025 June 2026

 

 

success Thank you! We're glad to hear that this topic was useful.
success We appreciate your feedback. We'll work to make this topic better for you in the future.