Storage
This API allows you to upload files to the Unifically storage service using three different methods: direct file upload, base64-encoded upload, or URL-based upload.
Upload Methods
Method 1: Direct File Upload (Form Data)
Upload a file directly from your local system using multipart/form-data.
Request
curl --location --request PUT 'https://files.storagecdn.online/upload' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'file=@"/path/to/your/file.png"'Parameters
file
File
Yes
The file to upload. Use @ prefix followed by the file path
Example
curl --location --request PUT 'https://files.storagecdn.online/upload' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'file=@"/Users/john/Documents/image.png"'Use Cases
Uploading files from local file system
Direct file uploads from applications
Best for: Command-line uploads, server-to-server transfers
Method 2: Base64 Upload (JSON)
Upload a file as a base64-encoded string in JSON format. Base64 string can be either raw or data string
Request
curl --location --request PUT 'https://files.storagecdn.online/upload' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
}'Request Body
{
"base64": "YOUR_BASE64_ENCODED_FILE_STRING"
}Parameters
base64
String
Yes
Base64-encoded file content
Example
curl --location --request PUT 'https://files.storagecdn.online/upload' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
}'Use Cases
Uploading files from web applications
When file is already in base64 format
Best for: Browser-based uploads, embedded images, API integrations
Notes
Ensure your file is properly base64-encoded before sending
Base64 encoding increases file size by approximately 33%
Maximum file size may be limited by your API plan
Method 3: File URL Upload (JSON)
Upload a file by providing a publicly accessible URL. The server will fetch and store the file.
Request
curl --location --request PUT 'https://files.storagecdn.online/upload' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"file_url": "https://example.com/path/to/file.png"
}'Request Body
{
"file_url": "https://example.com/path/to/file.png"
}Parameters
file_url
String (URL)
Yes
Publicly accessible URL of the file to upload
Example
curl --location --request PUT 'https://files.storagecdn.online/upload' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"file_url": "https://file.com/images/sample.png"
}'Use Cases
Importing files from external sources
Migrating files from other storage services
Best for: Bulk imports, file migrations, webhook integrations
Requirements
The URL must be publicly accessible (no authentication required)
The file must be directly downloadable
HTTPS URLs are recommended
Response Format
Success Response
Status Code: 200 OK
{
"success": true,
"file_url": "https://files.storagecdn.online/image/2b847255-e028-4cf7-a2aa-c638f3e15cbc.webp"
}Error Response
Status Code: 400 Bad Request
{
"success": false,
"message": "Error message here"
}Last updated