Xeonr Developer Docs
UplApiIntegrations

Generate integration token

POST
/uplim.api.v1.IntegrationsService/GenerateIntegrationToken

Generates a long-lived access token scoped to an integration and resource. Requires upl:private scope and optionally auth:forever for non-expiring tokens.

Authorization

OAuth2 upl:private
AuthorizationBearer <token>

OAuth 2.0 authorization

In: header

Scope: upl:private

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

integrationId?string
Formatuuid
bucketRef?|

Reference to a bucket by ID or hostname

forever?boolean

If true, generate a non-expiring token (requires auth:forever scope on the subject token).

duration?string|null

Optional duration string (e.g. "30d", "1y"). Ignored if forever is true.

folderRef*|

Reference to a folder by ID or path

[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://uploads-api.xeonr.io/uplim.api.v1.IntegrationsService/GenerateIntegrationToken" \  -H "Connect-Protocol-Version: 1" \  -H "Content-Type: application/json" \  -d '{    "folderRef": {      "folderId": "string"    }  }'
{
  "accessToken": "string",
  "expiresAt": "2023-01-15T01:30:15.01Z"
}
{
  "code": "not_found",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}