Skip to main content
POST
/
{bucketName}
/
{*path}
Upload Object
curl --request POST \
  --url https://cdn.sacul.cloud/{bucketName}/{*path} \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "files": [
    null
  ]
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.sacul.cloud/llms.txt

Use this file to discover all available pages before exploring further.

Upload one or more files to a specific bucket and optional path.
As stated before and following our recent API update, uploading files is now exclusively supported via multipart/form-data.Old methods such as binary or base64 are now deprecated and removed from the API.

​
Authentication

Requires an API Key via Authorization, X-API-Key, or apiKey query parameter.

​
Headers

​
Content-Type
string
default:"multipart/form-data"
required
multipart/form-data

​
Query Parameters

​
overwrite
boolean
default:"false"
If false, handle duplicates with Windows-style (1) suffix.
​
randomizeName
boolean
default:"false"
If true, randomizes the filename with a UUID.

​
Form Data

​
files
file[]
required
One or more files to upload.

​
Response

{
    "success": true,
    "message": "Successfully uploaded X file(s)",
    "url": "https://cdn.sacul.cloud/bucket/file.png", 
    "urls": ["..."]
}

​
Examples

Standard Upload
curl -X POST https://cdn.sacul.cloud/my-bucket/images/ \
    -H "Authorization: Bearer <your-api-key>" \
    -F "files=@/path/to/your/image.png"
Batch Upload
curl -X POST https://cdn.sacul.cloud/my-bucket/uploads/ \
    -H "Authorization: Bearer <your-api-key>" \
    -F "[email protected]" \
    -F "[email protected]"