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.
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
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>
<platform API server>/qps/xsd/3.0/was/report.xsd