List existing columns with their per-type settings

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

import requests

url = "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "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>",
      "type": "AiAnalysis",
      "fieldFormat": {
        "baseFormat": "text",
        "description": "<string>",
        "enumerationValues": [
          {
            "value": "<string>",
            "label": "<string>"
          }
        ],
        "currency": "USD",
        "listElementBaseFormat": "text",
        "outputFields": [
          {
            "name": "<string>",
            "type": "text",
            "description": "<string>",
            "enumerationValues": [
              {
                "value": "<string>",
                "label": "<string>"
              }
            ]
          }
        ]
      },
      "index": 123,
      "autoRunOnRowAdd": true,
      "autoRunOnRowUpdate": true,
      "key": "<string>",
      "runCadenceSeconds": 123
    },
    "tableIndex": 123,
    "cardIndex": 123,
    "visibleInTable": true,
    "visibleInCard": true,
    "additionalFields": [
      {
        "key": "<string>",
        "name": "<string>",
        "fieldFormat": {
          "baseFormat": "text",
          "description": "<string>",
          "enumerationValues": [
            {
              "value": "<string>",
              "label": "<string>"
            }
          ],
          "currency": "USD",
          "listElementBaseFormat": "text",
          "outputFields": [
            {
              "name": "<string>",
              "type": "text",
              "description": "<string>",
              "enumerationValues": [
                {
                  "value": "<string>",
                  "label": "<string>"
                }
              ]
            }
          ]
        }
      }
    ],
    "webAgentModel": "Lite",
    "transformationModel": "Default",
    "linkSettings": {
      "sourceBridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "includedStatuses": [
        "<string>"
      ],
      "maxAgeRelativePeriod": "Future",
      "filters": {
        "groups": [
          {
            "terms": [
              {
                "field": "<string>",
                "operation": "Equals",
                "value": "<unknown>"
              }
            ]
          }
        ]
      }
    },
    "vendorPresenceSettings": {
      "serviceProviders": [
        {
          "name": "<string>",
          "serviceProviderAliases": [
            "<string>"
          ],
          "productNamesOrAliases": [
            "<string>"
          ],
          "inferenceContext": "<string>",
          "url": "<string>"
        }
      ],
      "runWebPresence": true,
      "contextPrompt": "<string>",
      "runContractEstimation": true,
      "lookbackYears": 123
    },
    "emailGenerationSettings": {
      "emailSubjectTemplate": "<string>",
      "emailBodyTemplate": "<string>",
      "showParentColumn": true,
      "snippetDefinitions": {}
    },
    "webhookUrl": "<string>",
    "linkToCellSettings": {
      "targetBridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "targetColumnId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sourceRowIdentity": "<string>"
    },
    "multiLinkSettings": {
      "sourceBridgeIds": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "includedStatuses": [
        "<string>"
      ],
      "maxAgeRelativePeriod": "Future"
    },
    "webContactSettings": {
      "subPrompt": "<string>",
      "examples": [
        "<string>"
      ],
      "additionalContext": "<string>"
    },
    "accountScoringMetadata": {
      "scoringConfig": {
        "fitColumns": [
          {
            "phaseId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "includedInScoring": true,
            "strongFitGuidance": "<string>"
          }
        ],
        "signalConfigs": {},
        "fitInteractionPrompt": "<string>",
        "signalInteractionPrompt": "<string>",
        "scoreInteractionPrompt": "<string>"
      },
      "signalBridgesByType": {}
    },
    "runConditions": {
      "groups": [
        {
          "terms": [
            {
              "field": "<string>",
              "operation": "Equals",
              "value": "<unknown>"
            }
          ]
        }
      ]
    }
  }
]

REST API

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, cross-bridge cell mirror) plus additionalFields synthetic refs (e.g. {columnId$basis:firstName}) usable in prompts or as referenceFieldPath on createReferenceColumn, and each column’s table and card positions and visibility. 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 --request GET \
  --url https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/column/metadata")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "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>",
      "type": "AiAnalysis",
      "fieldFormat": {
        "baseFormat": "text",
        "description": "<string>",
        "enumerationValues": [
          {
            "value": "<string>",
            "label": "<string>"
          }
        ],
        "currency": "USD",
        "listElementBaseFormat": "text",
        "outputFields": [
          {
            "name": "<string>",
            "type": "text",
            "description": "<string>",
            "enumerationValues": [
              {
                "value": "<string>",
                "label": "<string>"
              }
            ]
          }
        ]
      },
      "index": 123,
      "autoRunOnRowAdd": true,
      "autoRunOnRowUpdate": true,
      "key": "<string>",
      "runCadenceSeconds": 123
    },
    "tableIndex": 123,
    "cardIndex": 123,
    "visibleInTable": true,
    "visibleInCard": true,
    "additionalFields": [
      {
        "key": "<string>",
        "name": "<string>",
        "fieldFormat": {
          "baseFormat": "text",
          "description": "<string>",
          "enumerationValues": [
            {
              "value": "<string>",
              "label": "<string>"
            }
          ],
          "currency": "USD",
          "listElementBaseFormat": "text",
          "outputFields": [
            {
              "name": "<string>",
              "type": "text",
              "description": "<string>",
              "enumerationValues": [
                {
                  "value": "<string>",
                  "label": "<string>"
                }
              ]
            }
          ]
        }
      }
    ],
    "webAgentModel": "Lite",
    "transformationModel": "Default",
    "linkSettings": {
      "sourceBridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "includedStatuses": [
        "<string>"
      ],
      "maxAgeRelativePeriod": "Future",
      "filters": {
        "groups": [
          {
            "terms": [
              {
                "field": "<string>",
                "operation": "Equals",
                "value": "<unknown>"
              }
            ]
          }
        ]
      }
    },
    "vendorPresenceSettings": {
      "serviceProviders": [
        {
          "name": "<string>",
          "serviceProviderAliases": [
            "<string>"
          ],
          "productNamesOrAliases": [
            "<string>"
          ],
          "inferenceContext": "<string>",
          "url": "<string>"
        }
      ],
      "runWebPresence": true,
      "contextPrompt": "<string>",
      "runContractEstimation": true,
      "lookbackYears": 123
    },
    "emailGenerationSettings": {
      "emailSubjectTemplate": "<string>",
      "emailBodyTemplate": "<string>",
      "showParentColumn": true,
      "snippetDefinitions": {}
    },
    "webhookUrl": "<string>",
    "linkToCellSettings": {
      "targetBridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "targetColumnId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sourceRowIdentity": "<string>"
    },
    "multiLinkSettings": {
      "sourceBridgeIds": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "includedStatuses": [
        "<string>"
      ],
      "maxAgeRelativePeriod": "Future"
    },
    "webContactSettings": {
      "subPrompt": "<string>",
      "examples": [
        "<string>"
      ],
      "additionalContext": "<string>"
    },
    "accountScoringMetadata": {
      "scoringConfig": {
        "fitColumns": [
          {
            "phaseId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "includedInScoring": true,
            "strongFitGuidance": "<string>"
          }
        ],
        "signalConfigs": {},
        "fitInteractionPrompt": "<string>",
        "signalInteractionPrompt": "<string>",
        "scoreInteractionPrompt": "<string>"
      },
      "signalBridgesByType": {}
    },
    "runConditions": {
      "groups": [
        {
          "terms": [
            {
              "field": "<string>",
              "operation": "Equals",
              "value": "<unknown>"
            }
          ]
        }
      ]
    }
  }
]

Authorizations

Authorization

string

header

required

HTTP Bearer Authentication

Path Parameters

bridgeId

string

required

Response

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

tableIndex

integer

required

Zero-based position in the table view. Hidden system columns hold positions too, so use this number rather than the column's place in a list.

cardIndex

integer

required

Zero-based position in the card view. Hidden system columns hold positions too, so compare it only with other columns' cardIndex.

visibleInTable

boolean

required

Whether the column shows in the table view

visibleInCard

boolean

required

Whether the column shows in the card view

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

transformationModel

enum<string> | null

Transformation model tier — set on AI analysis columns. Default (free) or Opus (restricted to God/Internal user types).

Available options:

Default,

Opus

linkSettings

BridgeLinkSettings · object

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

Show child attributes

vendorPresenceSettings

BridgeCompetitorPresenceSettings · object | null

Vendor presence settings — set on vendor presence columns.

Show child attributes

emailGenerationSettings

BridgeEmailGenerationSettings · object | null

Email generation settings — set on email template columns.

Show child attributes

webhookUrl

string | null

Webhook URL — set on webhook columns.

linkToCellSettings

BridgeLinkToCellSettings · object | null

Cross-bridge cell-mirror settings — set on LinkToCell columns.

Show child attributes

multiLinkSettings

BridgeMultiLinkSettings · object | null

MultiLink settings — set on multi-link columns.

Show child attributes

webContactSettings

WebContactSettings · object | null

Show child attributes

accountScoringMetadata

BridgeAccountScoringMetadata · object | null

Account Score config of a Top Buyers bridge. The 0-100 score combines a fit half, driven by scoringConfig.fitColumns and scoringConfig.fitInteractionPrompt, with a signal half, driven by signalBridgesByType, scoringConfig.signalConfigs and scoringConfig.signalInteractionPrompt; scoringConfig.scoreInteractionPrompt decides how the two halves become the score.

Show child attributes

runConditions

TriggerFilters · object

Show child attributes

⌘I