REST API

Set Bridge Row Status

Set the user-facing status for a single row in a Bridge. The rowId must identify a row that belongs to the specified bridgeId. Use this when a caller needs to move one Bridge row to a new status without updating any other column values. Supported default values are New, Actioned, Saved, Not Interested. For conferences it might additionally include Attending, Sponsoring. In the UI, ‘New’ is shown as ‘Needs action’, and ‘Saved’ is shown as ‘Starred’. Filtering on Actioned will include Sponsoring and Attending.

PATCH

api

external

bridge

{bridgeId}

row

{rowId}

status

Set Bridge Row Status

curl --request PATCH \
  --url https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status', 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}/row/{rowId}/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

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

{
  "rowId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "bridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "columns": {},
  "name": "<string>",
  "buyerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organizerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "entity": {
    "id": "<string>"
  }
}

Authorizations

Authorization

string

header

required

HTTP Bearer Authentication

Path Parameters

bridgeId

string

required

rowId

string

required

Body

application/json

Bridge row status update

newStatus

enum<string>

required

Supported default values are New, Actioned, Saved, Not Interested. For conferences it might additionally include Attending, Sponsoring. In the UI, 'New' is shown as 'Needs action', and 'Saved' is shown as 'Starred'. Filtering on Actioned will include Sponsoring and Attending.

Available options:

New,

Actioned,

Saved,

Attending,

Sponsoring,

NotInterested

Response

Bridge row status updated

rowId

string<uuid>

required

Unique identifier for the row

bridgeId

string<uuid>

required

UUID of the bridge this row belongs to

createdAt

string

required

Timestamp when the row was created (added to the bridge).

updatedAt

string

required

Timestamp when the row was last updated. This is a technical last-updated field: in addition to
    meaningful changes (status, column values), non-meaningful changes such as a bulk re-sync or
    maintenance can also advance it. Sort by `rowUpdatedAt` to page through recently-changed rows.

status

enum<string>

required

Current processing status of the row

Available options:

NotProcessed,

Queued,

Processing,

Processed,

Failed,

Skipped

columns

object

required

Show child attributes

name

string | null

Optional name or title of the row

buyerId

string<uuid> | null

UUID of the buyer associated with this row, if any

organizerId

string<uuid> | null

UUID of the conference organizer associated with this row, if any

entity

BridgeRowEntityRef · object | null

Reference to the underlying entity (id + type) this row represents, when available.

Show child attributes

List existing columns with their per-type settingsUse 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`. Cross-reference entries to the bridge's columns from `getBridge` by `columnId` for the base column shape.

⌘I

Set Bridge Row Status

curl --request PATCH \
  --url https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status', 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}/row/{rowId}/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://dashboard.starbridge.ai/api/external/bridge/{bridgeId}/row/{rowId}/status")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

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

{
  "rowId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "bridgeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "columns": {},
  "name": "<string>",
  "buyerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organizerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "entity": {
    "id": "<string>"
  }
}