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

# List personalized release updates



## OpenAPI

````yaml /openapi/v3.yaml get /api/v2/release-updates
openapi: 3.1.0
info:
  title: Semicola Exchange platform API
  version: 3.0.0-preview
  description: >-
    Platform endpoints of Semicola: sign-in, signup and OAuth for MCP clients,
    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: Signup
  - name: OAuth
  - name: Accounts
  - name: Members
  - name: API Keys
  - name: Buyer Agent Principals
  - name: Asks
  - name: Connected Apps
  - name: Onboarding
  - name: Billing
  - name: AI Usage
  - name: Notifications
  - name: Assistant
  - name: MCP Apps
  - name: Realtime
  - name: Demo
paths:
  /api/v2/release-updates:
    get:
      tags:
        - Notifications
      summary: List personalized release updates
      operationId: getReleaseUpdates
      parameters:
        - name: scope
          in: query
          required: false
          schema:
            default: for_you
            type: string
            enum:
              - for_you
              - explore
              - all
        - name: since
          in: query
          required: false
          schema:
            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)))$
        - name: skip
          in: query
          required: false
          schema:
            default: 0
            type: integer
            minimum: 0
            maximum: 9007199254740991
        - name: take
          in: query
          required: false
          schema:
            default: 20
            type: integer
            minimum: 1
            maximum: 100
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    anyOf:
                      - type: object
                        properties:
                          scope:
                            type: string
                            enum:
                              - for_you
                              - explore
                              - all
                          updates:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                version:
                                  type: string
                                releasedAt:
                                  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)))$
                                description:
                                  type: string
                                tier:
                                  type: string
                                  enum:
                                    - fix
                                    - improvement
                                    - feature
                                    - headline
                                audience:
                                  anyOf:
                                    - type: string
                                      enum:
                                        - buyers
                                        - sellers
                                        - all
                                    - type: 'null'
                                feature:
                                  anyOf:
                                    - type: object
                                      properties:
                                        key:
                                          type: string
                                        title:
                                          type: string
                                        description:
                                          type: string
                                        maturity:
                                          anyOf:
                                            - type: string
                                              enum:
                                                - alpha
                                                - beta
                                                - ga
                                                - retired
                                            - type: 'null'
                                        docsUrl:
                                          anyOf:
                                            - type: string
                                              format: uri
                                            - type: 'null'
                                      required:
                                        - key
                                        - title
                                        - description
                                        - maturity
                                        - docsUrl
                                      additionalProperties: false
                                    - type: 'null'
                                relevance:
                                  type: array
                                  items:
                                    type: string
                                    enum:
                                      - affected
                                      - configured
                                      - eligible
                                      - enrolled
                                      - using
                                reason:
                                  type: string
                                  enum:
                                    - affected
                                    - configured
                                    - broad
                                    - explore
                                    - history
                                unread:
                                  type: boolean
                              required:
                                - id
                                - version
                                - releasedAt
                                - description
                                - tier
                                - audience
                                - feature
                                - relevance
                                - reason
                                - unread
                              additionalProperties: false
                          totalCount:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          unreadCount:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          lastSeenAt:
                            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'
                          hasMore:
                            type: boolean
                          generatedAt:
                            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:
                          - scope
                          - updates
                          - totalCount
                          - unreadCount
                          - lastSeenAt
                          - hasMore
                          - generatedAt
                        additionalProperties: false
                      - type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                          message:
                            type: string
                          field:
                            type: string
                          details: {}
                        required:
                          - code
                          - message
                        additionalProperties: false
                      - type: 'null'
                required:
                  - data
                  - error
                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

````