List existing columns with their per-type settings

Use to inspect which columns already exist on this bridge and how they are configured. Returns each column’s per-type settings not carried by getBridge (link settings, web-agent model, vendor presence, email generation, webhook URL) plus additionalFields synthetic refs (e.g. {columnId$basis:firstName}) usable in prompts or as referenceFieldPath on createReferenceColumn. Cross-reference entries to the bridge’s columns from getBridge by columnId for the base column shape.

GET /api/external/bridge/{bridgeId}/column/metadata

List existing columns with their per-type settings

cURL

curl --request GET \
  --url https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "columnId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "bridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "column": {
      "columnId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "bridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "prompt": "<string>",
      "fieldFormat": {
        "description": "<string>",
        "enumerationValues": [
          {
            "value": "<string>",
            "label": "<string>"
          }
        ],
        "outputFields": [
          {
            "name": "<string>",
            "description": "<string>"
          }
        ]
      },
      "index": 123,
      "key": "<string>"
    },
    "additionalFields": [
      {
        "key": "<string>",
        "name": "<string>",
        "fieldFormat": {
          "description": "<string>",
          "enumerationValues": [
            {
              "value": "<string>",
              "label": "<string>"
            }
          ],
          "outputFields": [
            {
              "name": "<string>",
              "description": "<string>"
            }
          ]
        }
      }
    ],
    "linkSettings": {
      "sourceBridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "includedStatuses": [
        "<string>"
      ]
    },
    "vendorPresenceSettings": {
      "serviceProviders": [
        {
          "name": "<string>",
          "serviceProviderAliases": [
            "<string>"
          ],
          "productNamesOrAliases": [
            "<string>"
          ]
        }
      ],
      "runWebPresence": true,
      "contextPrompt": "<string>",
      "runContractEstimation": true
    },
    "emailGenerationSettings": {
      "emailSubjectTemplate": "<string>",
      "emailBodyTemplate": "<string>",
      "showParentColumn": true,
      "snippetDefinitions": {}
    },
    "webhookUrl": "<string>"
  }
]

Authorizations

Authorization · string · header · required

HTTP Bearer Authentication

Path Parameters

bridgeId · string · required

Response

200

application/json

Per-column metadata for existing columns

columnId · string<uuid> · required

UUID of the existing column. Duplicated from column.columnId for backwards compatibility.

bridgeId · string<uuid> · required

UUID of the bridge this column belongs to. Duplicated from column.bridgeId for backwards compatibility.

column · BridgeColumnResponse · object · required

Show child attributes

additionalFields · BridgeRowAttributeOption · object[] · required

Extra reference paths exposed by this column. For basis columns (e.g. a Get Contact column that attaches contact records), these surface synthetic refs like {columnId$basis:firstName} you can plug into prompts or referenceFieldPath on createReferenceColumn.

Show child attributes

webAgentModel · enum<string> | null

Web agent model — set on web-agent columns.

Available options: Lite, Base, Core, Core2X, Pro, Ultra, UltraTwoX, UltraFourX, UltraEightX

linkSettings · BridgeLinkSettings · object

Cross-bridge link settings — set on cross-bridge reference columns.

Show child attributes

vendorPresenceSettings · BridgeCompetitorPresenceSettings · object

Vendor presence settings — set on vendor presence columns.

Show child attributes

emailGenerationSettings · BridgeEmailGenerationSettings · object

Email generation settings — set on email template columns.

Show child attributes

webhookUrl · string | null

Webhook URL — set on webhook columns.