Use this endpoint to update attributes of a Report. It supports the same JSON attributes defined in the creation endpoint.
This endpoint is currently in Private Preview.
Note that you don't need to include collection_type in the request body since this attribute is automatically inferred.
This endpoint supports partial updates: only the attributes provided in the request body will be modified. However, list-based attributes follow a "full replace" logic: if a list is included in the payload, its current contents will be entirely overwritten by the new data. To add, remove or change items from a list, you must include the entire set of elements in your request. We recommend fetching the current object first to ensure existing items are preserved before submitting your update.
Examples
Set the description to "Work in progress" for Report report--f64d8bb1acdd4fb498082b9c48e92c67 and overwrite its tags to "WIP" and "P0". Additionally, assign Ana as author.
import requests
object_id = "report--f64d8bb1acdd4fb498082b9c48e92c67"
url = f"https://www.virustotal.com/api/v3/collections/{object_id}"
payload = {
"data": {
"type": "collection",
"attributes": {
"description": "Work in progress",
"tags":["WIP", "P0"],
"author": "Ana"
}
}
}
headers = {"accept": "application/json","x-apikey": <api-key>,"content-type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)