Post mediauploads

Uploads a private-by-default file to quarantine. Only clean files can be downloaded.

POST /media/uploads

Error

A valid request URL is required to generate request examples

201

{
  "media_id": "<string>",
  "original_name": "<string>",
  "mime_type": "application/pdf",
  "size_bytes": 26214400,
  "visibility": "private",
  "scan_status": "pending_scan",
  "status": "active",
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data

file · file · required

visibility · enum<string> · default: private

Available options: private, public

Response

201

application/json

Upload stored in quarantine and awaiting malware scan.

media_id · string · required

original_name · string · required

mime_type · enum<string> · required

Available options: application/pdf, image/jpeg, image/png, image/webp

size_bytes · integer<int64> · required

Required range: 1 <= x <= 52428800

visibility · enum<string> · required

Available options: private, public

scan_status · enum<string> · required

Available options: pending_scan, scanning, clean, infected, scan_failed

status · enum<string> · required

Available options: active, deleted

created_at · string<date-time> · required