Sandbox: Submit Sample

post

https://sandbox.recordedfuture.com/api/v0/samples

Submit a file or URL for sandbox malware analysis via upload, fetch, or import modes.

Body Params

kind

string

enum

required

Submission type: file (upload), url (analyze URL), fetch (download and analyze), or import (re-analyze existing sample).

Allowed:

file

The file to upload. Required when kind is file.

url

string

The URL to analyze or fetch. Required when kind is url or fetch.

interactive

boolean

Defaults to false

If true, pauses after static analysis for manual profile selection via POST /samples/{sampleID}/profile.

password

string

Decryption password for archive files (zip/rar/etc).

profiles

array of objects

Explicit file-to-profile mappings for analysis.

profiles

user_tags

array of strings

Custom identification strings (max 1kB total).

user_tags

target

string

Custom filename override or URL destination.

_json

string

Alternative: pass all parameters as a JSON string in this field instead of individual form fields.

defaults

object

Default analysis parameters for automatic mode.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Sample accepted for analysis.