API SpecificationUploads
List uploads
Lists uploads in a bucket with optional filtering by path, date, and tags. Supports cursor-based pagination.
Authorization
OAuth2 upl:bucket:readAuthorizationBearer <token>
OAuth 2.0 authorization
In: header
Scope: upl:bucket:read
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 to list uploads from
path?string|null
Optional path to filter uploads
year?integer|null
Optional year to filter uploads
Format
int32month?integer|null
Optional month to filter uploads
Format
int32tags?tags
Optional tags to filter uploads
cursor*string
[key: string]?never
Response Body
application/json
application/json
curl -X POST "https://uploads-api.xeonr.io/uplim.api.v1.BucketUploadsService/ListUploads" \ -H "Connect-Protocol-Version: 1" \ -H "Content-Type: application/json" \ -d '{ "cursor": "string" }'{
"uploads": [
{
"uploadId": "string",
"filename": "string",
"path": "string",
"slug": "string",
"url": "string",
"contentUrl": "string",
"sizeBytes": 0,
"type": "UPLOAD_TYPE_UNSPECIFIED",
"tags": [
"string"
],
"oauthClientId": "6d6c655c-ec4d-46c8-93fc-cca588313cab",
"oauthApplicationId": "6e68418e-eaad-4fd1-af9d-e9521eee4cbc",
"allowAnyExtension": true,
"defaultSlugExtension": "string",
"generatedDescription": "string",
"metaUploads": [
{
"type": {
"type": "MetaUploadType_UNSPECIFIED",
"n": 0,
"filename": "string"
},
"metadataId": "string",
"uploadUrl": "string",
"downloadUrl": "string"
}
],
"private": true,
"aliases": [
{
"aliasId": "string",
"uploadId": "string",
"path": "string",
"slug": "string",
"url": "string",
"hasPassword": true,
"expiresAt": "2023-01-15T01:30:15.01Z",
"maxUses": 0,
"useCount": 0,
"allowedUserIds": [
0
],
"createdAt": "2023-01-15T01:30:15.01Z"
}
]
}
],
"nextCursor": "string"
}{
"code": "not_found",
"message": "string",
"details": [
{
"type": "string",
"value": "string",
"debug": {}
}
]
}