Xeonr Developer Docs
UplApiuplim.api.v1.PipelineAdminService

ResolveStepRef

POST
/uplim.api.v1.PipelineAdminService/ResolveStepRef

Resolves a step ref ("@") to its registry manifest. Used by the visual builder so port lists, required_secrets, and the config schema render as the user wires inputs. Fetches from the upl-im-steps registry through the same path PublishPipeline uses when snapshotting — so what the UI shows is what publish would freeze. Read-only.

Authorization

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 in1
Connect-Timeout-Ms?number

Define the timeout, in ms

Request Body

application/json

ref?string

"@" (e.g. "[email protected]"). Sub-pipeline refs ("pipeline:@") are accepted but not resolved here — the visual builder treats them as composite nodes.

Length3 <= length
integrationId?string

Optional: integration scope for the registry lookup (private-per- integration manifests). May be empty — server derives from the step ref's URN-form name prefix when absent. Accepts a UUID or a slug when present.

[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://uploads-api.xeonr.io/uplim.api.v1.PipelineAdminService/ResolveStepRef" \  -H "Connect-Protocol-Version: 1" \  -H "Content-Type: application/json" \  -d '{}'
{
  "manifest": {
    "name": "string",
    "version": "string",
    "kind": "PIPELINE_STEP_KIND_UNSPECIFIED",
    "kinds": [
      "PIPELINE_RESOURCE_KIND_UNSPECIFIED"
    ],
    "inputs": [
      {
        "name": "string",
        "schemaJson": "string",
        "required": true,
        "isBlob": true
      }
    ],
    "outputs": {
      "blobs": [
        {
          "name": "string",
          "required": true,
          "envelopeSchemaJson": "string",
          "mimeHint": "string",
          "maxSizeBytes": 0
        }
      ],
      "kv": [
        {
          "name": "string",
          "required": true,
          "valueType": "METADATA_VALUE_TYPE_UNSPECIFIED"
        }
      ],
      "locals": [
        {
          "name": "string",
          "required": true,
          "valueType": "METADATA_VALUE_TYPE_UNSPECIFIED"
        }
      ],
      "localBlobs": [
        {
          "name": "string",
          "required": true,
          "mimeHint": "string"
        }
      ]
    },
    "requiredSecrets": [
      "string"
    ],
    "configSchemaJson": "string",
    "runtimeVersion": "string",
    "description": "string",
    "readmeMd": "string",
    "rendererRef": {
      "archiveUploadId": "0f00a816-1fc2-4597-bbce-ea7af713750b",
      "contentTypeUrn": "string",
      "entry": "string"
    },
    "exec": {
      "image": "string",
      "imageDigest": "string",
      "command": [
        "string"
      ],
      "args": [
        "string"
      ]
    },
    "bundleSha256": "string"
  }
}
{
  "code": "not_found",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}