The new docs.trellix.com features a modernized UI and AI-powered conversational search. Content is currently available in English, with additional languages launching in early November 2026. We hope you enjoy the updated experience.

Update VA scan request parameters

Prev Next

Updates a VA scan.

Service

update-scan

Permission

Update scan XML API

Version

4.4.9 or higher

Parameter

Definition

HH$Id

ID of the scan to update

HH$Name

String

HH$Description

String

HH$Schedule

Schedule in cross tab format

HH$DatabasesAdd

Add comma-separated list of DB IDs

HH$DatabasesRemove

Remove comma-separated list of DB IDs

HH$GroupsAdd

Add comma-separated list of DB group names

HH$GroupsRemove

Remove comma-separated list of DB group names

HH$DatabaseExceptionsAdd

Add comma-separated list of DB IDs to exclude from the scan

HH$DatabaseExceptionsRemove

Remove comma-separated list of DB IDs to exclude from the scan

HH$TagsAdd

Add comma-separated list of categories (tags)

HH$TagsRemove

Remove comma-separated list of categories (tags)

HH$OmmittedRulesAdd

Add comma-separated list of rule IDs to exclude from the scan

HH$OmmittedRulesRemove

Remove comma-separated list of rule IDs to exclude from the scan

HH$actions

Comma-separated list of actions

Available actions: LOG, EMAIL, SYSLOG, WINLOG, FILELOG, and AUTO_RESOLVE

HH$winLevel

Winlog level

HH$fileLevel

File log level

HH$sysLevel

Syslog level

HH$resolve

Name of resolution (in case AUTO_RESOLVE action is set)

HH$email

Email address (in case EMAIL action is set)

HH$Severity

Comma-separated list of severities to check (HIGH, MEDIUM, LOW, NOTICE, and INFO)

HH$Enabled

Boolean

HH$StorePassword

Boolean — Store weak passwords

HH$RebuildPassword

Boolean — Rebuilds the password cache

HH$OUs

Comma-separated list of OUs

HH$Server

The server that this scan belongs to (relevant when the Server is configured as a cluster)

For example, to update scan with ID#10009000 and add database with IDs #10006000 and 10007000 submit the request:

https://127.0.0.1:8443/xmlapi.svc?service=update-scan&HH$Id=10009000&HH$DatabasesAdd=10006000,10007000