Xeonr Developer Docs
UplApiIntegration Admin

Upsert integration bucket type

POST
/uplim.api.v1.IntegrationAdminService/UpsertIntegrationBucketType

Creates or updates a bucket type for an integration, with ownership verification.

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

Connect-Timeout-Ms?number

Define the timeout, in ms

Request Body

application/json

integrationId?string

The parent integration that owns this bucket type

Formatuuid
updateMask?string
slug?string|null

URL-safe identifier (e.g. "npm-registry"). Immutable after creation.

Formathostname
Length1 <= length <= 64
displayName?string|null
Length1 <= length <= 128
description?string|null
Lengthlength <= 1024
iconUrl?string|null

Deprecated — the icon is now uploaded via CreateIntegrationBucketTypeIconUploadIntent and identified by icon_upload_id below. Field kept for one cycle so older clients don't error; server ignores the value on new writes.

Formaturi
Lengthlength <= 2048
renderer?|null
serviceAccountPermission?string|null

Permission level for the auto-provisioned service account (read, write, admin)

Lengthlength <= 16
iconUploadId?string|null

Upload ID of a custom icon image. Server resolves to icon_url at read time by presigning the internal-bucket upload. Mirrors the IntegrationContentType.icon_upload_id pattern. Mint via CreateIntegrationBucketTypeIconUploadIntent.

Match^$|^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://uploads-api.xeonr.io/uplim.api.v1.IntegrationAdminService/UpsertIntegrationBucketType" \  -H "Connect-Protocol-Version: 1" \  -H "Connect-Timeout-Ms: 1000" \  -H "Content-Type: application/json" \  -d '{}'
{
  "bucketType": {
    "id": "string",
    "integrationId": "string",
    "slug": "string",
    "displayName": "string",
    "description": "string",
    "iconUrl": "string",
    "renderer": {
      "enabled": true,
      "archiveUploadId": "0f00a816-1fc2-4597-bbce-ea7af713750b",
      "entryPath": "string"
    },
    "createdAt": "2023-01-15T01:30:15.01Z",
    "updatedAt": "2023-01-15T01:30:15.01Z",
    "serviceAccountId": "string",
    "serviceAccountPermission": "string",
    "iconUploadId": "string"
  }
}
{
  "code": "not_found",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}