> ## Documentation Index
> Fetch the complete documentation index at: https://hc.starbridge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml https://core-http2-157602306522.us-central1.run.app/external/public/swagger/documentation.yaml patch /api/external/bridge/{bridgeId}/row/{rowId}/status
openapi: 3.1.1
info:
  title: Starbridge External Public API
  version: '1.0'
servers:
  - url: https://dashboard.starbridge.ai
security: []
paths:
  /api/external/bridge/{bridgeId}/row/{rowId}/status:
    patch:
      tags:
        - Bridges
        - External MCP
        - External API
      summary: Set Bridge Row Status
      description: >-
        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.
      operationId: setBridgeRowStatus
      parameters:
        - name: bridgeId
          in: path
          required: true
          schema:
            type: string
        - name: rowId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        description: Bridge row status update
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetBridgeRowStatusRequest'
        required: true
      responses:
        '200':
          description: Bridge row status updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BridgeRowResponse'
        '400':
          description: Invalid request body or format
        '401':
          description: Missing or invalid authentication
        '403':
          description: Unauthorized to access resource or perform action
        '404':
          description: Resource not found
        '415':
          description: Unsupported media type or request body format
        '429':
          description: Rate limit exceeded
        '500':
          description: Internal server error
      security:
        - apiKey: []
components:
  schemas:
    SetBridgeRowStatusRequest:
      type: object
      title: SetBridgeRowStatusRequest
      required:
        - newStatus
      properties:
        newStatus:
          $ref: '#/components/schemas/BridgeRowStatus'
    BridgeRowResponse:
      type: object
      title: BridgeRowResponse
      required:
        - rowId
        - bridgeId
        - createdAt
        - updatedAt
        - status
        - columns
      properties:
        rowId:
          type: string
          description: Unique identifier for the row
          format: uuid
        name:
          type:
            - string
            - 'null'
          description: Optional name or title of the row
        bridgeId:
          type: string
          description: UUID of the bridge this row belongs to
          format: uuid
        createdAt:
          type: string
          description: Timestamp when the row was created (added to the bridge).
        updatedAt:
          type: string
          description: |2-

                    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:
          type: string
          description: Current processing status of the row
          enum:
            - NotProcessed
            - Queued
            - Processing
            - Processed
            - Failed
            - Skipped
        buyerId:
          type:
            - string
            - 'null'
          description: UUID of the buyer associated with this row, if any
          format: uuid
        organizerId:
          type:
            - string
            - 'null'
          description: UUID of the conference organizer associated with this row, if any
          format: uuid
        entity:
          oneOf:
            - $ref: '#/components/schemas/BridgeRowEntityRef'
            - type: 'null'
        columns:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/BridgeRowColumnValueResponse'
    BridgeRowStatus:
      type: string
      title: BridgeRowStatus
      description: >-
        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.
      enum:
        - New
        - Actioned
        - Saved
        - Attending
        - Sponsoring
        - NotInterested
    BridgeRowEntityRef:
      type: object
      title: BridgeRowEntityRef
      description: >-
        Reference to the underlying entity (id + type) this row represents, when
        available.
      required:
        - type
        - id
      properties:
        type:
          type: string
          description: Kind of entity `id` refers to (e.g. Conference, Buyer, Opportunity).
          enum:
            - RFP
            - Meeting
            - Purchase
            - Buyer
            - TopBuyer
            - Contact
            - Signal
            - Conference
            - JobChange
            - SequenceBuyer
            - SequenceContact
            - SequenceJobChange
            - VendorPresence
            - ProductCompetitorPresence
            - CompanionPresence
        id:
          type: string
          description: >-
            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.
    BridgeRowColumnValueResponse:
      type: object
      title: BridgeRowColumnValueResponse
      properties:
        value:
          description: >-
            Any JSON value - can be a string, number, boolean, object, array, or
            null
        status:
          type:
            - string
            - 'null'
          description: Processing status of this column value
          enum:
            - NotProcessed
            - Queued
            - Processing
            - Processed
            - Failed
            - Skipped
        processedAt:
          type:
            - string
            - 'null'
          description: Timestamp when the value was successfully processed
  securitySchemes:
    apiKey:
      scheme: bearer
      description: HTTP Bearer Authentication
      type: http

````