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

# Conversation list feed (SSE fallback)



## OpenAPI

````yaml /openapi/v3.yaml get /api/v2/assistant/conversations/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/assistant/conversations/events:
    get:
      tags:
        - Assistant
      summary: Conversation list feed (SSE fallback)
      operationId: getAssistantConversationsEvents
      parameters:
        - 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: conversations.changed
                      id:
                        type: string
                      data:
                        type: object
                        properties:
                          conversations:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                  minLength: 6
                                customerId:
                                  type: integer
                                  exclusiveMinimum: 0
                                  maximum: 9007199254740991
                                createdBy:
                                  type: integer
                                  exclusiveMinimum: 0
                                  maximum: 9007199254740991
                                title:
                                  type:
                                    - string
                                    - 'null'
                                scopeType:
                                  type: string
                                  enum:
                                    - customer
                                    - advertiser
                                scopeId:
                                  type: string
                                workspace:
                                  anyOf:
                                    - type: string
                                      enum:
                                        - inventory
                                        - advertisers
                                        - buyers
                                        - agents
                                        - campaigns
                                    - type: 'null'
                                language:
                                  anyOf:
                                    - type: string
                                      enum:
                                        - ar
                                        - de
                                        - en
                                        - es
                                        - fr
                                        - hi
                                        - it
                                        - ko
                                        - nl
                                        - pl
                                        - pt
                                        - sv
                                        - tr
                                        - ja
                                        - zh
                                    - type: 'null'
                                sharingEnabled:
                                  type: boolean
                                lastMessageAt:
                                  anyOf:
                                    - type: string
                                      format: date-time
                                      pattern: >-
                                        ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                                    - type: 'null'
                                createdAt:
                                  type: string
                                  format: date-time
                                  pattern: >-
                                    ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                                updatedAt:
                                  type: string
                                  format: date-time
                                  pattern: >-
                                    ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                              required:
                                - id
                                - customerId
                                - createdBy
                                - title
                                - scopeType
                                - scopeId
                                - workspace
                                - language
                                - sharingEnabled
                                - lastMessageAt
                                - createdAt
                                - updatedAt
                              additionalProperties: false
                          presenceByConversationUid:
                            type: object
                            propertyNames:
                              type: string
                            additionalProperties:
                              type: array
                              items:
                                type: object
                                properties:
                                  conversationId:
                                    type: string
                                    minLength: 6
                                  customerId:
                                    type: integer
                                    exclusiveMinimum: 0
                                    maximum: 9007199254740991
                                  userId:
                                    type: integer
                                    exclusiveMinimum: 0
                                    maximum: 9007199254740991
                                  lastSeenAt:
                                    type: string
                                    format: date-time
                                    pattern: >-
                                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                                  typing:
                                    type: boolean
                                required:
                                  - conversationId
                                  - customerId
                                  - userId
                                  - lastSeenAt
                                  - typing
                                additionalProperties: false
                          totalCount:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          hasMore:
                            type: boolean
                        required:
                          - conversations
                          - presenceByConversationUid
                          - totalCount
                          - hasMore
                        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

````