Merge branch 'main' of github.com:adobe/spacecat-api-service into feat/serenity-init

Author: dmitriigulkin-semrush

.github/workflows/e2e-tests.yaml

@@ -14,12 +14,12 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           persist-credentials: 'false'
 
       - name: Set up Node
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version-file: '.nvmrc'
 

CHANGELOG.md

@@ -1,3 +1,10 @@
+## [1.488.1](https://github.com/adobe/spacecat-api-service/compare/v1.488.0...v1.488.1) (2026-05-11)
+
+
+### Bug Fixes
+
+* enable category filtering in filter-dimensions ([#2356](https://github.com/adobe/spacecat-api-service/issues/2356)) ([37938ef](https://github.com/adobe/spacecat-api-service/commit/37938ef3758879e76e0de16d451caf22b01647e3))
+
 # [1.488.0](https://github.com/adobe/spacecat-api-service/compare/v1.487.0...v1.488.0) (2026-05-11)
 
 

docs/openapi/api.yaml

@@ -500,6 +500,8 @@ paths:
     $ref: './llmo-api.yaml#/llmo-agentic-traffic-weeks'
   /sites/{siteId}/agentic-traffic/movers:
     $ref: './llmo-api.yaml#/llmo-agentic-traffic-movers'
+  /org/{spaceCatId}/brands/{brandId}/brand-presence/filter-dimensions:
+    $ref: './llmo-api.yaml#/brand-presence-filter-dimensions'
   /org/{spaceCatId}/brands/{brandId}/brand-presence/prompt-execution-status:
     $ref: './llmo-api.yaml#/brand-presence-prompt-execution-status'
   /org/{spaceCatId}/brands/{brandId}/brand-presence/url-inspector/stats:

docs/openapi/llmo-api.yaml

@@ -3275,6 +3275,53 @@ llmo-agentic-traffic-movers:
       - ims_key: []
       - scoped_api_key: []
 
+brand-presence-filter-dimensions:
+  parameters: *url-inspector-common-params
+  get:
+    tags:
+      - llmo
+    summary: Filter dimensions for the Brand Presence config dashboard
+    description: |
+      Returns the distinct brands, categories, topics, regions, origins, page intents,
+      and prompt stats available for the given organization. Used to populate the
+      filter dropdowns in the Brand Presence configuration view.
+
+      Brand scoping is driven by the `brandId` path segment:
+        * `brands/{brandId}` → filter by that specific brand
+        * `brands/all`       → aggregate across all brands (filterByBrandId = null)
+
+      Use `siteId` to further narrow brand options to those linked to a specific site.
+      Use `categoryId` to scope the returned topics and prompt count to a single category.
+    operationId: getBrandPresenceFilterDimensions
+    parameters:
+      - name: siteId
+        in: query
+        required: false
+        description: Optional site UUID to narrow brand options to those linked to the site
+        schema: { type: string, format: uuid }
+      - name: categoryId
+        in: query
+        required: false
+        description: Optional category UUID to scope topics and prompt count to a single category
+        schema: { type: string, format: uuid }
+    responses:
+      '200':
+        description: Filter dimensions for the Brand Presence config view
+        content:
+          application/json:
+            schema:
+              $ref: './schemas.yaml#/BrandPresenceFilterDimensions'
+      '400': { $ref: './responses.yaml#/400' }
+      '401': { $ref: './responses.yaml#/401' }
+      '403': { $ref: './responses.yaml#/403' }
+      '500': { $ref: './responses.yaml#/500' }
+      '503':
+        description: PostgREST / mysticat not configured for this deployment
+    security:
+      - api_key: []
+      - ims_key: []
+      - scoped_api_key: []
+
 brand-presence-prompt-execution-status:
   parameters: *url-inspector-common-params
   get:

docs/openapi/schemas.yaml

@@ -8503,6 +8503,61 @@ UrlInspectorFilterDimensions:
           label: { type: string }
         required: [id, label]
   required: [categories, regions, content_types]
+
+BrandPresenceFilterOption:
+  type: object
+  description: A single id/label option for a filter dropdown
+  properties:
+    id: { type: string }
+    label: { type: string }
+  required: [id, label]
+
+BrandPresenceFilterDimensions:
+  type: object
+  description: |
+    Filter dimensions for the Brand Presence configuration view.
+    Each dimension is an array of id/label pairs except `stats`.
+  properties:
+    brands:
+      type: array
+      description: Brands accessible for the organization (and optionally a specific site).
+      items:
+        $ref: '#/BrandPresenceFilterOption'
+    categories:
+      type: array
+      description: Prompt categories configured for the organization.
+      items:
+        $ref: '#/BrandPresenceFilterOption'
+    topics:
+      type: array
+      description: Topics for the organization, optionally scoped to a category.
+      items:
+        $ref: '#/BrandPresenceFilterOption'
+    regions:
+      type: array
+      description: Available region codes.
+      items:
+        $ref: '#/BrandPresenceFilterOption'
+    origins:
+      type: array
+      description: Prompt origin values (e.g. `human`, `ai`).
+      items:
+        $ref: '#/BrandPresenceFilterOption'
+    page_intents:
+      type: array
+      description: Page intent values derived from the brand's prompt data.
+      items:
+        $ref: '#/BrandPresenceFilterOption'
+    stats:
+      type: object
+      description: Aggregate statistics for the current filter scope.
+      properties:
+        distinct_prompt_count:
+          type: integer
+          description: Number of distinct prompts matching the current filter scope.
+      required: [distinct_prompt_count]
+  required: [brands, categories, topics, regions, origins, page_intents, stats]
+
 WebhookAccepted:
   type: object
   properties: