Reference

Asynchronously bulk update alerts using query params to target the alerts

post
https://www.virustotal.com/api/v3/dtm/alerts/bulk/apply

Asynchronously update alerts using query params to taget which alerts will be updated.

Query Params
boolean
Defaults to false

If true, then alert buckets are updated where applicable.

string

Only return alerts for the given monitor ID. This parameter can be specified multiple times to filter on more than one monitor ID.

boolean

If true, then only alerts that have analysis are returned. An alert has anlysis if it has either analysis text or analysis file attachments.

date-time

When listing alerts by date range, since defines the starting date in RFC3339 format

date-time

When listing alerts by date range, until defines the ending date in RFC3339 format

string
enum

Filter alerts by their status. This parameter can be specified multiple times.

string
enum

Filter alerts by alert type. This parameter can be specified multiple times.

string

Search alert and triggering doc contents based on a simple Lucene query string including 1 or more text values separated by AND or OR.

string

If specified, then only alerts that have the given match value are returned. This parameter can be repeated multiple times.

string

Filter alerts by tag(s). This parameter can be used more than once to filter on multiple tags.

string
enum

When using the search parameter, its value can be base64 encoded in which case search_encoding indicates the value encoding type.

Allowed:
string
enum

Return alerts that have the given severity. This parameter can be repeated multiple times.

Allowed:
integer
0 to 100

Filter alerts with mscores greater than or equal to the given value.

Body Params

Asynchronously update alerts based on query parameters.

add_tags
array of strings

Tags to add on any alerts updated. Duplicate tags will not be created on any alert.

add_tags
exlcude_ids
array of strings

If provided, an array of alert IDs that should be explictly skipped during the update operation.

exlcude_ids
remove_tags
array of strings

Tags to remove on any alerts updated.

remove_tags
string
enum

The status to apply to the alerts.

Headers
string
required

Your API key

string
enum
required

The content type of the body.

Allowed:
Responses
202

Accepted and will be processed in the background.

Updated 7 months ago

Language
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 7 months ago