Create profile

Create a reusable sandbox analysis profile defining OS, locale, network, timeout, and browser settings.

What this endpoint does

Creates a reusable analysis profile for your sandbox organization. Profiles define the execution environment for malware analysis — OS, locale, network routing, timeout, and browser preference. Use Sandbox: List Resources to discover valid OS tags (e.g., os:windows10-2004-x64) and locale tags. Network mode controls how the sample communicates: internet for direct connectivity, tor for anonymized routing, vpn with a geolocation tag for region-specific analysis, or sim200/sim404/simnx for simulated HTTP responses (useful for triggering malware fallback behaviors). Profile names must be unique — a 409 means the name is taken. Once created, reference the profile by ID or name when calling Sandbox: Submit Sample.

Response data

Returns the newly created profile with its system-assigned UUID, confirming the configuration the sandbox will use when this profile is selected for analysis. The profile is immediately available for use in sample submissions. Note that options and geolocation return null when not specified in the request.

Body Params
string
required

Unique profile name

tags
array of strings
required

OS and locale tags (e.g., os:windows10-2004-x64, locale:en-us)

tags*
integer
required

Analysis duration in seconds (max 3600)

string
enum
required

Network mode

string

Geographic region for VPN routing (required when network is vpn)

options
object
Responses

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