Uninstall a Single Agent

[POST] /qps/rest/2.0/uninstall/am/asset/<id>

Uninstall a single cloud agent and remove the associated agent host from your subscription.

Where “id” (Required) is the asset ID of the agent you want to uninstall. This is the asset ID where the agent is installed.

Good to Know - A request to uninstall an agent makes a call to the Qualys Cloud Platform to purge the host scan data (findings) for the agent host and remove the agent host from your subscription.

Permissions required - Managers with full scope. Other users must have these permissions: Access Permission “API Access” and CA Agent Permission “Uninstall Agent".

Input ParametersInput Parameters

There are no input parameters.

Sample - Uninstall single agentSample - Uninstall single agent

API request

curl -u fo_username:password -X POST -H "Content-Type: text/xml" --data-binary @single_uninstall.xml
"<qualys_base_url>/qps/rest/2.0/uninstall/am/asset/1113679"      
    

Contents of single_uninstall.xml

<?xml version="1.0" encoding="UTF-8" ?>
<ServiceRequest></ServiceRequest>      
    

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/2.0/am/asset.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>1</count>
    <data>
        <Asset>
            <id>1113679</id>
        </Asset>
    </data>
</ServiceResponse>      
    

XSD

<platform API server>/qps/xsd/2.0/am/asset.xsd