API SpecificationPublic Uploads
Get public upload
Retrieves a public upload, folder listing, or alias access requirement. Supports password-protected aliases. No authentication required.
AuthorizationBearer <token>
JWT access token obtained via OAuth2 flow or service account
In: header
Header Parameters
Connect-Protocol-Version*number
Define the version of the Connect protocol
Value in
1Connect-Timeout-Ms?number
Define the timeout, in ms
Request Body
application/json
bucketRef?|
Reference to the bucket
path?string
Full path including slug (e.g., "/photos/image.jpg" or "/" for root listing)
Match
^\/([a-zA-Z0-9 _\-\.\/]*)?$Length
1 <= length <= 512aliasPassword?string|null
Password for alias access (if required)
[key: string]?never
Response Body
application/json
application/json
curl -X POST "https://uploads-api.xeonr.io/uplim.api.v1.PublicUploadsService/GetPublicUpload" \ -H "Connect-Protocol-Version: 1" \ -H "Content-Type: application/json" \ -d '{}'{
"aliasAccessRequired": {
"filename": "string",
"sizeBytes": 0,
"type": "UPLOAD_TYPE_UNSPECIFIED",
"requirement": "ALIAS_ACCESS_REQUIREMENT_UNSPECIFIED"
}
}{
"code": "not_found",
"message": "string",
"details": [
{
"type": "string",
"value": "string",
"debug": {}
}
]
}