Rescan a private file

🚧

Special privileges required

Private Scanning is only available to users with the Google Threat Intelligence Enterprise or Enterprise Plus licenses.

Reanalyses a private file. The same params from /files (other than the file) are accepted. Returns a private analysis.

{
	"data": {
		"type": "private_analysis",
		"id": "ZmI5Y2VmNGJmZDIwZTkzNmQ5MzY0NTcwMGI2Nzc2M2Q6Tm9uZToxNjYwODI1NDE1"
	}
}

Rescanning Password-Protected Files

When rescanning a password-protected archive or encrypted document, pass the optional password query parameter (a UTF-8 string up to 128 characters). Google TI uses the password to extract bundled inner files into bundled_files and analyze the sample in supported private dynamic analysis sandboxes:

curl --request POST \
     --url "https://www.virustotal.com/api/v3/private/files/{sha256}/analyse?password=infected" \
     --header "x-apikey: YOUR_API_KEY" \
     --header "accept: application/json"
Path Params
string
required

File's SHA256 hash

Query Params
string

Optional password (up to 128 UTF-8 characters) to decrypt password-protected archives (ZIP, 7z, RAR) and encrypted documents (PDF, Office), extract bundled inner files, and analyze them in supported private dynamic analysis sandboxes.

string

Command line arguments to use when running the file in sandboxes.

string
Defaults to false

If true, then the file won't be detonated in sandbox environments. False by default.

string
Defaults to false

If the file should have internet access when running in sandboxes. False by default.

string
Defaults to false

Intercept HTTPS/TLS/SSL communication. Intercept HTTPS to view encypted URLS, hostnames and HTTP headers. This is detectable by any sample that checks certificates, and makes JA3 hashes unusable.

string
Defaults to cape

Select the sandbox desired for interactive use.

int32
60 to 1800
Defaults to 60

Interaction timeout in seconds, minimum value: 60. (1 minute.) Max value: 1800: (30 minutes).

Headers
string
required

Your API key

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json