---
title: "Set Bridge Row Status"
method: PATCH
path: "/api/external/bridge/{bridgeId}/row/{rowId}/status"
tags: ["Bridges", "External MCP", "External API"]
---

# Set Bridge Row Status

`PATCH /api/external/bridge/{bridgeId}/row/{rowId}/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.

## Path parameters

- `bridgeId` string, required
- `rowId` string, required

## Request body

- SetBridgeRowStatusRequest
  - `newStatus` 'New' | 'Actioned' | 'Saved' | 'Attending' | 'Sponsoring' | 'NotInterested', 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.

## Response `200`

Bridge row status updated

- BridgeRowResponse
  - `rowId` string, uuid, required — Unique identifier for the row
  - `name` string, nullable — Optional name or title of 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` 'NotProcessed' | 'Queued' | 'Processing' | 'Processed' | 'Failed' | 'Skipped', required — Current processing status of the row
  - `buyerId` string, uuid, nullable — UUID of the buyer associated with this row, if any
  - `organizerId` string, uuid, nullable — UUID of the conference organizer associated with this row, if any
  - `entity` BridgeRowEntityRef — Reference to the underlying entity (id + type) this row represents, when available.
    - `type` 'RFP' | 'Meeting' | 'Purchase' | 'Buyer' | 'TopBuyer' | 'Contact' | 'Signal' | 'Conference' | 'JobChange' | 'SequenceBuyer' | 'SequenceContact' | 'SequenceJobChange' | 'VendorPresence' | 'ProductCompetitorPresence' | 'CompanionPresence', required — Kind of entity `id` refers to (e.g. Conference, Buyer, Opportunity).
    - `id` string, required — Identifier of the underlying entity. Pass to entity-specific tools (e.g. opportunity line items, file downloads) to fetch detail beyond the bridge's columns.
  - `columns` object, required

## Other responses

- `400` — Invalid request body or format
- `401` — Missing or invalid authentication
- `403` — Unauthorized to access resource or perform action
- `404` — Resource not found
- `415` — Unsupported media type or request body format
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/starbridge/apis/starbridge-external-public-api.md) · [All operations](https://skmtc.dev/starbridge/apis/starbridge-external-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/starbridge/starbridge-external-public-api/revisions/dc7faf636b78/schema)