Upload file

POST /v1/files/upload

Uploads one or more files to the system using multipart form data. The endpoint validates the uploaded files, applies default processing, and stores them at the specified path. Returns the storage path and public URL(s) for accessing the uploaded file(s) after successful processing.

Request Body

file: @file(/Users/erikhvamandersen/Desktop/verygood.jpg) @contentType(image/jpeg)

Response Example

{
  "data": {
    "path": "/tenant-id-1/banner/file-id-1"
  },
  "files": [
    "https://api.example.com/v1/files/public/tenants/tenant-id-1/banner/file-id-1/logo-1700000000000.png"
  ],
  "message": "File(s) successfully uploaded"
}