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

# The What's New entries the back office switched on

> Returns the product-news entries currently live for the app's What's New modal. The same for every merchant; each entry says which stores should see it (`installed_before`). Read-only.



## OpenAPI

````yaml /api-reference/openapi/lite.json get /announcements
openapi: 3.1.0
info:
  title: Search & Merchandising API
  version: 1.0.0
  description: >-
    REST API behind Depict: Search & Merchandising, the native Shopify app:
    onboarding, collections, boost & bury, dashboards, A/B testing and
    multi-store management. Endpoints are served under the /api/lite prefix and
    are authenticated with the Shopify session token that App Bridge issues to
    the embedded app.
servers:
  - url: /api/lite
security:
  - ShopifySessionToken: []
paths:
  /announcements:
    get:
      summary: The What's New entries the back office switched on
      description: >-
        Returns the product-news entries currently live for the app's What's New
        modal. The same for every merchant; each entry says which stores should
        see it (`installed_before`). Read-only.
      operationId: announcements
      responses:
        '200':
          description: The live entries.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnnouncementsResponse'
        '401':
          description: Not authenticated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
        '403':
          description: Authenticated, but this identity may not call the API.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
        '500':
          description: Internal error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Detail'
components:
  schemas:
    AnnouncementsResponse:
      type: object
      properties:
        version:
          type: integer
          description: '0 when the back office never saved: the app shows its built-in list.'
        announcements:
          type: array
          items:
            $ref: '#/components/schemas/Announcement'
          description: Entries switched on and inside their date window (at most 25).
      required:
        - version
        - announcements
    Detail:
      type: object
      properties:
        detail:
          type: string
      required:
        - detail
      description: 'Every 4xx/5xx body: `{detail}`.'
    Announcement:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        body:
          type: string
          description: Plain text; **double asterisks** render bold.
        installed_before:
          type:
            - string
            - 'null'
          description: >-
            YYYY-MM-DD: show only to stores installed before this date; null =
            every store.
        asset:
          type:
            - string
            - 'null'
          description: Key of a media set bundled with the app.
        light_image_url:
          type:
            - string
            - 'null'
        dark_image_url:
          type:
            - string
            - 'null'
        light_video_url:
          type:
            - string
            - 'null'
        dark_video_url:
          type:
            - string
            - 'null'
        cta:
          type:
            - object
            - 'null'
          properties:
            label:
              type: string
            href:
              type: string
          required:
            - label
            - href
      required:
        - id
        - title
        - body
        - installed_before
        - asset
        - light_image_url
        - dark_image_url
        - light_video_url
        - dark_video_url
        - cta
  securitySchemes:
    ShopifySessionToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Shopify App Bridge session token of the embedded Depict: Search &
        Merchandising app. The shop in the token determines the merchant;
        merchant_id parameters must belong to that shop.

````