Generate Direct Upload Metadata

Updated about 2 hours ago•1 min read
POST

/v1/attachments/direct_uploads

Generates pre-signed S3/ActiveStorage direct upload headers and URL to stream large files directly to cloud storage without overloading the API gateway.

Parameters

NameTypeDescription
filenamerequiredstringOriginal filename with extension (e.g. 'invoice.pdf')
byte_sizerequiredintegerFile size in bytes
checksumrequiredstringBase64 MD5 checksum of the file
content_typerequiredstringMIME type (e.g. 'application/pdf', 'image/png')

Responses

200Direct upload metadata
{
  "data": {
    "id": "blb_123",
    "key": "blobs/xyz987...",
    "signed_id": "eyJfcmFpbHMiOnsibWVzc2FnZSI6...",
    "direct_upload": {
      "url": "https://s3.eu-central-1.amazonaws.com/deskbolic-storage/...",
      "headers": {
        "Content-Type": "application/pdf"
      }
    }
  }
}