Update Report

[POST] /qps/rest/3.0/update/was/report/<id>

Update the tags assigned to a report which is in the user’s scope. Want to find a report ID to use as input? See Search reports.

Permissions required - User must have WAS module enabled. User account must have these permissions: Access Permission “API Access” and "Edit Report” permission. The output includes reports in the user's scope.

Input ParametersInput Parameters

The elements “id” (integer) and “tags” (complex element) are required, where “id” identifies a report and “tags” identifies tags to be added or removed.

The element “showPatched” can be set to filter the report to include/not include findings with virtual patches. Applies to Web Application Report and Scan Report. This filter can be set to:

SHOW_ONLY - show patched findings only

SHOW_BOTH - show patched & unpatched findings (default)

SHOW_NONE - show unpatched findings only

Click here for available operators

Sample - Update a report - add a tagSample - Update a report - add a tag

Let us update the report with ID 1304 by tagging the report.

API request

curl -u "USERNAME:PASSWORD" -H "content-type: text/xml" -X "POST" --data-binary @-
"<qualys_base_url>/qps/rest/3.0/update/was/report/1304" < file.xml
Note: “file.xml” contains the request POST data.         
    

Request POST data

<ServiceRequest>
    <data>
    <Report>
        <tags>
        <set>
            <Tag>
            <id>99509</id>
            </Tag>
            <Tag>
            <id>99510</id>
            </Tag>
        </set>
        </tags>
    </Report>
    </data>
</ServiceRequest>      
    

XML response

<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/qps/xsd/3.0/was/report.xsd"
    <ServiceResponse>
        <count>1</count>
        <data>
            <Report>
                <id>1304</id>
            </Report>
        </data>
        <responseCode>SUCCESS</responseCode>
    </ServiceResponse>      
    

XSD

<platform API server>/qps/xsd/3.0/was/report.xsd