RErecordedfuture

Submit a sample

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

post/samples

Request

  • Base URL
    https://sandbox.recordedfuture.com/api/v0
  • URL
    https://sandbox.recordedfuture.com/api/v0/samples
  • Auth
    API key in header Authorization

Request body multipart/form-data

kind'file' | 'url' | 'fetch' | 'import' required

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

filestring binary

The file to upload. Required when kind is file.

urlstring

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

interactiveboolean

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

passwordstring

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

user_tagsstring[]

Custom identification strings (max 1kB total).

targetstring

Custom filename override or URL destination.

_jsonstring

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

Response

Sample accepted for analysis.

idstring

Assigned sample ID

status'pending'

Initial status (always 'pending')

kind'file' | 'url'

Submission type

filenamestring

Original filename (file submissions only)

urlstring

Submitted URL (URL submissions only)

privateboolean

Whether the sample is private

submittedstring date-time

ISO 8601 submission timestamp

Changes

No recorded changes to this operation across all 1 revision of this API.