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

# SSE fallback feed of row changes for the requested topics



## OpenAPI

````yaml /openapi/v3.yaml get /api/v2/realtime/events
openapi: 3.1.0
info:
  title: Semicola Exchange API
  version: 3.0.0-preview
  description: >-
    Platform endpoints of Semicola: sign-in and accounts, members and keys,
    billing, notifications, the Semi assistant (chat stream, confirmations,
    conversations), the MCP App widget host and realtime feeds. Typed agent
    tools live on the MCP server at /mcp/v3.
servers:
  - url: https://api.semicola.com
security:
  - bearerAuth: []
  - sessionCookie: []
tags:
  - name: Auth
  - name: Accounts
  - name: Billing
  - name: Notifications
  - name: Assistant
  - name: Widget host
  - name: Realtime
  - name: Demo
paths:
  /api/v2/realtime/events:
    get:
      tags:
        - Realtime
      summary: SSE fallback feed of row changes for the requested topics
      operationId: getRealtimeEvents
      parameters:
        - name: topics
          in: query
          required: true
          schema:
            type: string
        - name: Last-Event-ID
          in: header
          required: false
          schema:
            type: string
          description: Resume after this event sequence id.
      responses:
        '200':
          description: OK
          content:
            text/event-stream:
              schema:
                type: string
                description: Server-sent events; each `data:` line carries one frame below.
              x-event-schema:
                oneOf:
                  - type: object
                    properties:
                      event:
                        type: string
                        const: ready
                      id:
                        type: string
                      data:
                        type: object
                        properties:
                          transport:
                            type: string
                            enum:
                              - electric
                              - fallback
                          conversationUid:
                            type: string
                            minLength: 6
                          after:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                        required:
                          - transport
                        additionalProperties: false
                    required:
                      - event
                      - data
                    additionalProperties: false
                  - type: object
                    properties:
                      event:
                        type: string
                        const: transport.changed
                      id:
                        type: string
                      data:
                        type: object
                        properties:
                          transport:
                            type: string
                            enum:
                              - electric
                              - fallback
                        required:
                          - transport
                        additionalProperties: false
                    required:
                      - event
                      - data
                    additionalProperties: false
                  - type: object
                    properties:
                      event:
                        type: string
                        const: row.changed
                      id:
                        type: string
                      data:
                        type: object
                        properties:
                          table:
                            type: string
                            enum:
                              - conversations
                              - conversation_messages
                              - conversation_presence
                              - notifications
                              - seller_responses
                              - proposals
                              - proposal_executions
                              - approval_requests
                              - rfp_turns
                              - media_buys
                          op:
                            type: string
                            enum:
                              - insert
                              - update
                              - delete
                          key:
                            type: string
                          row:
                            anyOf:
                              - type: object
                                propertyNames:
                                  type: string
                                additionalProperties: {}
                              - type: 'null'
                        required:
                          - table
                          - op
                          - key
                          - row
                        additionalProperties: false
                    required:
                      - event
                      - data
                    additionalProperties: false
        default:
          description: >-
            Error envelope `{data: null, error: {code, message, field?,
            details?}}`.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or OAuth access token.
    sessionCookie:
      type: apiKey
      in: cookie
      name: sc_session

````