Submit URLs for analysis.

post

https://api-YOUR-INSTANCE.analysis.threatray.com/v1/submissions/urls

Submit a URL for analysis. All files downloaded from the URL are dynamically analyzed based on the parameters given.

Body Params

enable_network

boolean

Defaults to true

Enable or disable network access for the dynamic analysis environment. This only applies to dynamic analyses.

environments

array of strings

Defaults to win10_latest_x64

The dynamic analysis operating systems to be used for the analysis. This only applies to dynamic analyses.

environments

first_seen

integer

Defaults to now

First seen timestamp in UNIX-epoch format of the submitted URL.

label

string

Label of the URL and its downloaded files.

priority

enum

Priority tier of the analysis. Determines scheduling priority relative to other queued analyses. Accepted values: "high", "normal", "low". Numeric values 0-9 are deprecated but still accepted for backwards compatibility. They map to tiers as follows: 0 = low, 1-4 = normal, 5-9 = high.

timeout

integer

15 to 1500

Defaults to 180

Timeout of the dynamic analysis in seconds. This only applies to dynamic analyses.

url

string

required

URL to be submitted for analysis.

Response

Language

Loading…

Response

Choose an example:

application/json

200The response contains the URL that was submitted and the respective task that is handling the analysis.