Xeonr Developer Docs
API SpecificationUpload Aliases

Update upload alias

POST
/uplim.api.v1.UploadAliasService/UpdateUploadAlias

Updates alias settings including password, expiry, use limits, and allowed users.

Authorization

OAuth2 upl:bucket:manage
AuthorizationBearer <token>

OAuth 2.0 authorization

In: header

Scope: upl:bucket:manage

Header Parameters

Connect-Protocol-Version*number

Define the version of the Connect protocol

Value in1
Connect-Timeout-Ms?number

Define the timeout, in ms

Request Body

application/json

bucketRef?|
aliasId?string
password?string|null

New password (optional, set to empty string to remove)

expiresAt?string

New expiry (optional)

Formatdate-time
clearExpiresAt?boolean|null

Whether to clear the expiry

maxUses?integer|null

New max uses (optional)

Formatint32
clearMaxUses?boolean|null

Whether to clear max uses (unlimited)

allowedUserIds?

New allowed user IDs (optional, empty to clear restrictions)

updateAllowedUsers?boolean|null

Whether to update allowed_user_ids

[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://uploads-api.xeonr.io/uplim.api.v1.UploadAliasService/UpdateUploadAlias" \  -H "Connect-Protocol-Version: 1" \  -H "Content-Type: application/json" \  -d '{}'
{
  "alias": {
    "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"
  }
}
{
  "code": "not_found",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}