analyses

Use the endpoint to manage analyses.

DELETE analyses/<analysis_id:uuid>

Description

Parameters

Result

Delete analysis.

Analysis is deleted, code 204.

GET analyses

Description

Result

Get data about analyses.

List of Analysis objects.

Parameters

Parameter

Type

Description

Required

count

integer

Number of returning objects, 1…100. To get more objects, use several requests and the offset parameter. By default, count=10.

No

offset

integer

Offset, 0…+∞. By default, offset=0.

No

format_group_name

string

Filter by file type.

No

GET analyses/<analysis_id:uuid>

Description

Parameters

Result

Get detailed information about analysis.

Analysis object.

GET analyses/<analysis_id:uuid>/archive

Description

Parameters

Result

Download the archive with analysis results.

Archive that contains analysis results on all tasks.

GET analyses/<analysis_id:uuid>/sample

Description

Parameters

Result

Download sample.

Sample.

GET analyses/<analysis_id:uuid>/cureit

Description

Parameters

Result

Get data about CureIt!.

CureIt object.

GET analyses/<analysis_id:uuid>/cureit.exe

Description

Parameters

Result

Download the CureIt! utility.

Cureit! file.

POST analyses

Description

Result

Start the file analysis.

Analysis object.

Parameters

Parameter

Type

Description

Required

sample_id

integer

Sample ID.

Yes

analysis_time

integer

Sample run time in seconds, from 30 to the maximum sample run time permitted by your license. By default, analysis_time=60.

No

convert_video

boolean

Convert video while the analysis is ongoing.

No

copylog

boolean

Сopy full raw hypervisor log.

No

crypto_api_limit

integer

Crypto API buffers limit in MB.

No

custom_cmd

string/null

Command to run the sample.

No

drop_size_limit

integer

Total size limit for created files.

No

dump_browsers

string

Dump browser modules.

No

dump_mapped

boolean

Dump memory-mapped files (only after execution).

No

dump_processes

boolean

Dump processes (only after execution).

No

dump_size_limit

integer

Maximum size of collectable drops.

No

dump_ssdt

boolean

Dump SSDT.

No

flex_time

boolean

Sample flex time.

No

format_name

string

File format.

Yes if the format is not identified automatically

forwards

array [string]/null

Forward the specified ports from guest VM.

No

generate_cureit

boolean

Generate the Dr.Web CureIt! utility for neutralizing threats in the original file and in all files created during the analysis.

No

get_lib

boolean

Get *.lib files and raw dumps.

No

injects_limit

integer

Injects count limit.

No

monkey_clicker

boolean

Enable auto clicker.

No

net

string

Command to redirect virtual machine network traffic according to specified settings.

VPN = vpn:// (used by default if the net parameter is not specified)

TOR = tor://

Socks4 = socks4://host:port

Socks5 = socks5://[login:password@]host:port?parameters

Shadowsocks = shadowsocks://[login:password@]host:port?parameters

Possible values for parameters:

udp—UDP protocol behavior (udp=on redirects all UDP traffic, udp=off does not redirect traffic);

login:password—proxy server authorization parameters (optional for Socks5, required for Shadowsocks).

No

no_clean

boolean

Get all allocs and drops.

No

optional_count

integer/null

Maximum number of triggered breakpoints.

No

platforms

array [string]/null

Platforms to run the sample.

No

proc_lifetime

string/null

Lifetime of processes in seconds.

Example:

'notepad.exe,35,winword.exe,20

No

set_date

string

Set system date (format: 17.03.2022).

No

write_file_limit

integer

WriteFile buffers limit in MB.

No

POST analyses/<analysis_id:uuid>/restart

Description

Parameters

Result

Restart all deleted or failed tasks of the specified analysis.

Restart of deleted or failed tasks.

PUT analyses/<analysis_id>/cureit

Description

Parameters

Result

Recreate Cureit!.

CureIt object.