Skip to main content
POST
/
v2
/
file
/
upload
File Upload（V2）
curl --request POST \
  --url https://api.threatbook.io/v2/file/upload
{
  "data": {
    "sha256": "d79c9643d76062f553f76bb20b07da88fdbf5ddf3428ffc0223bb7bf90e36deb",
    "permalink": "https://ati.threatbook.io/hash/d79c9643d76062f553f76bb20b07da88fdbf5ddf3428ffc0223bb7bf90e36deb"
  },
  "response_code": 200,
  "msg": "Success"
}

Documentation Index

Fetch the complete documentation index at: https://docs.threatbook.io/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
apikey
string
required

Your API Key

You are able to get the key on "My API" page of i.threatbook.io.

Kindly note:

Please check if you have bound your access IP to the key and have the authority quotas to access this API before you interact with it.

​
file
string
required

Files to be analyzed must be no larger than 100 MB.

  • Note: Do not upload files exceeding 100 MB.
  • Supported file types include:
    PE executables (EXE, DLL, COM, etc.), Office documents (DOC, XLS, PPT, etc.), PDF, HTML, script files, MSI, SWF, JAR, LNK, ELF, and various archive formats (ZIP, RAR, 7Z, etc.).
​
sandbox_type
string

Sandbox Execution Environment
Users can specify the sandbox environment in which the file will be executed.

Available environments include:

  • Windows:

    • win7_sp1_enx64_office2013
    • win7_sp1_enx86_office2013
    • win7_sp1_enx86_office2010
    • win7_sp1_enx86_office2007
    • win7_sp1_enx86_office2003
    • win10_1903_enx64_office2016

  • Linux:

    • ubuntu_1704_x64
    • centos_7_x64

  • Kylin:

    • kylin_desktop_v10
​
run_time
integer

The sandbox execution time is 60s by default and can be adjusted as needed, up to a maximum of 300s.

Response

​
data
object
required
​
response_code
integer
required
​
msg
string
required