Update Scan Template

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

V2.0V3.0V4.0

V2.0

PUT /api/2.0/fo/report/template/scan/?action=update

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

Input ParametersInput Parameters

Click here to view parameters for updating scan templates.

Sample - Update Scan TemplateSample - Update Scan Template

API Request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With:curl" -X PUT -H "Content-type: text/xml" --data-binary @scan_export.xml "<qualys_base_url>/api/2.0/fo/report/template/scan/?action=update&template_id=8209&report_format=xml"

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:52:34Z</DATETIME>
    <CODE>Scan Report Template Updated Successfully [8209]</CODE>
    <TEXT></TEXT>
  </RESPONSE>
</SIMPLE_RETURN>

DTD

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

V3.0

PUT /api/3.0/fo/report/template/scan/?action=update

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

Input ParametersInput Parameters

Click here to view parameters for updating scan templates.

Sample - Update Scan TemplateSample - Update Scan Template

API Request

curl --location '<qualys_base_url> /api/3.0/fo/report/template/scan/?action=update&report_format=xml&template_id=3038062' \
--header 'X-Requested-With: curl' \
--header 'content-type: text/xml' \
--header 'Authorization: encoded username:passwordstring' \
--data '<?xml version="1.0" encoding="UTF-8" ?>

XML Response

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE SIMPLE_RETURN SYSTEM "
<qualys_base_url>/api/3.0/simple_return.dtd">
    <SIMPLE_RETURN>
        <RESPONSE>
            <DATETIME>2025-03-04T06:10:09Z</DATETIME>
            <TEXT>Scan Report Template Successfully Updated.</TEXT>
            <ITEM_LIST>
                <ITEM>
                    <KEY>ID</KEY>
                    <VALUE>3038062</VALUE>
                </ITEM>
            </ITEM_LIST>
        </RESPONSE>
    </SIMPLE_RETURN>

DTD

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

V4.0

PUT /api/4.0/fo/report/template/scan/?action=update

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

Input ParametersInput Parameters

Click here to view parameters for updating scan templates.

Sample - Update Scan TemplateSample - Update Scan Template

API Request

curl --location --request POST '<qualys_base_url>/api/4.0/fo/report/template/scan/?action=update&report_format=xml&template_id=8708009' \
--header 'Accept: */*' \
--header 'X-Requested-With: curl' \
--header 'content-type: text/xml' \
--header 'Authorization: Basic Encoded username:passwordstring'

XML Response

<?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:46:08Z</DATETIME>
        <TEXT>Scan Report Template Successfully Updated.</TEXT>
        <ITEM_LIST>
            <ITEM>
                <KEY>ID</KEY>
                <VALUE>8737800</VALUE>
            </ITEM>
        </ITEM_LIST>
    </RESPONSE>
</SIMPLE_RETURN>     </SIMPLE_RETURN>

DTD

<platform API server>/api/4.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/4.0/fo/report/template/scan/?action=update Active Active
/api/3.0/fo/report/template/scan/?action=update December 2025

June 2026

/api/2.0/fo/report/template/scan/?action=update 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.