pathParts
. The filename is sanitized using transliteration.
Headers
Must be
multipart/form-data
Body Parameters (multipart/form-data)
The file to upload. Must not exceed 15MB.
A JSON stringified array of folder path segments (e.g.,
["profile", "images"]
)Response
Unique identifier for the uploaded file
Relative path to the file (e.g., “profile/images/photo.jpg”)
Public URL to access the file
Error Responses
Missing File - 400 Bad Request
Missing File - 400 Bad Request
Invalid Path Parts - 400 Bad Request
Invalid Path Parts - 400 Bad Request
File Too Large - 413 Payload Too Large
File Too Large - 413 Payload Too Large
Server Error - 500 Internal Server Error
Server Error - 500 Internal Server Error
Notes
- Requires authentication
- The uploaded file is stored at the location specified by
pathParts
, with the filename sanitized - Returns a public URL to access the file
- Maximum file size: 15MB
- Content-Type must be
multipart/form-data
- Rate limiting: 50 requests per 5 minutes