docs: update openAPI spec

Author: JayKid

docs/index.html

@@ -194,6 +194,7 @@ llmo-config:
       Retrieves the LLMO (Large Language Model Optimizer) configuration for a specific site.
       This endpoint retrieves the configuration directly from S3 storage. The configuration
       includes entities (categories, topics), brand aliases, and competitor information.
+      Categories may include optional URLs for content matching.
 
       If a version parameter is provided, the specific version of the configuration will be
       retrieved. If the version does not exist, a 404 error will be returned. If no version
@@ -238,6 +239,9 @@ llmo-config:
       This operation completely overwrites the existing configuration with the provided payload.
       The payload is validated against the LLMO configuration schema before being stored in S3.
       The configuration must include entities, brands, and competitors sections.
+      
+      Categories can optionally include URLs that can be either exact URLs or URL prefixes
+      (ending with /*) to match against specific content areas.
     operationId: postLlmoConfig
     requestBody:
       required: true

docs/openapi/llmo-api.yaml

@@ -3805,6 +3805,11 @@ LlmoConfig:
         "123e4567-e89b-12d3-a456-426614174000":
           name: "Technology"
           region: "us"
+          urls:
+            - value: "https://example.com/tech"
+              type: "url"
+            - value: "https://example.com/technology/*"
+              type: "prefix"
     topics:
       type: object
       description: A record of topics with nested prompts keyed by UUID
@@ -3884,8 +3889,37 @@ LlmoCategory:
             pattern: '^[a-z][a-z]$'
           description: Array of two-letter region codes
           example: ["us", "eu"]
+    urls:
+      type: array
+      description: Optional array of URLs associated with this category
+      items:
+        $ref: '#/LlmoCategoryUrl'
+      example:
+        - value: "https://example.com/tech"
+          type: "url"
+        - value: "https://example.com/news/*"
+          type: "prefix"
   additionalProperties: true
 
+LlmoCategoryUrl:
+  type: object
+  description: A URL configuration for a category
+  required:
+    - value
+    - type
+  properties:
+    value:
+      type: string
+      description: The URL value - can be a complete URL or a URL prefix
+      minLength: 1
+      example: "https://example.com/tech"
+    type:
+      type: string
+      enum: ["url", "prefix"]
+      description: The type of URL - 'url' for exact URLs, 'prefix' for URL prefixes (ending with /*)
+      example: "url"
+  additionalProperties: false
+
 LlmoTopic:
   type: object
   description: A topic in the LLMO configuration with nested prompts