Quarantine Release

Service name: mav_quarantine_release

Base URL

https://{SERVER}/api/?apikey={yourAPIkey}&service=mav_quarantine_release

Description

Release threats from the Managed Antivirus quarantine on the specified device.

Parameters

Required parameters

Add required parameters immediately after the base URL.

https://{SERVER}/api/?apikey={yourAPIkey}&service=mav_quarantine_release&required_parameters={parameter-value}
ParameterDescriptionTypeOptionsDefault
deviceidThe deviceid must be a valid device id.integer00
guidsThe data parameter is one (or more as a sequence of comma separated values) GUID code(s) as return by mav_quarantine_list quarantineguidstring00

Optional parameters

Add optional parameters after the required parameters in the base URL.

https://{SERVER}/api/?apikey={yourAPIkey}&service=mav_quarantine_release&required_parameters={parameter-value}&optional_parameters={parameter-value}
ParameterDescriptionTypeOptionsDefault
describeOptional. Returns a description of the entered call, the available parameters, an example of its output, and returned fields with descriptions.booleantrue0

Determine parameter values

Use the following associated service calls to determine parameter values.

ParameterCallURL Format
deviceidlist_devices_at_clienthttps://{SERVER}/api/?apikey=yourAPIkey&service=list_devices_at_client&clientid=CLIENTID&devicetype=server
list_servershttps://{SERVER}/api/?apikey=yourAPIkey&service=list_servers&siteid=SITEID
list_workstationshttps://{SERVER}/api/?apikey=yourAPIkey&service=list_workstations&siteid=SITEID
siteidlist_siteshttps://{SERVER}/api/?apikey=yourAPIkey&service=list_sites&clientid=CLIENTID
clientidlist_clientshttps://{SERVER}/api/?apikey=yourAPIkey&service=list_clients

Examples

Release threats from quarantine for a device

https://{SERVER}/api/?apikey={yourAPIkey}&service=mav_quarantine_release&deviceid=DEVICEID&guids=GUID,{GUID},{GUID}

Example response - Success

<?xml version="1.0" ?>
<result created="2024-08-25T15:54:05" host="SERVER" status="OK">
  <msg />
</result>

Example response - Failure

<?xml version="1.0" ?>
<result created="2024-08-25T15:54:05" host="SERVER" status="FAIL">
  <msg>{fail message}</msg>
</result>

Returned fields

FieldTypeCan Be EmptyDescription
msgstringyesMessage related to the action status.