[NA] [SDK] [DOCS] Update automatically OpenAPI spec and Fern code (#4445)

Co-authored-by: Andres Cruz <[email protected]>

Author: github-actions[bot]

apps/opik-documentation/documentation/fern/docs/agent_optimization/opik_optimizer/reference.mdx

@@ -1,11 +1,6 @@
 ---
-headline: API Reference | Opik Documentation
-og:description: Explore tools to optimize LLM prompts and agents with the standardized
-  API for consistent optimization across multiple algorithms.
-og:site_name: Opik Documentation
-og:title: API Reference - Opik Agent Optimizer SDK
-subtitle: Technical SDK reference guide
-title: Opik Agent Optimizer API Reference
+title: "Opik Agent Optimizer API Reference"
+subtitle: "Technical SDK reference guide"
 ---
 
 The Opik Agent Optimizer SDK provides a comprehensive set of tools for optimizing LLM prompts and agents. This reference guide documents the standardized API that all optimizers follow, ensuring consistency and interoperability across different optimization algorithms.
@@ -802,10 +797,10 @@ optimize_prompt(
 <ParamField path="args" type="Any" />
 <ParamField path="kwargs" type="Any" />
 
-## HRPO
+## HierarchicalReflectiveOptimizer
 
 ```python
-HRPO(
+HierarchicalReflectiveOptimizer(
     model: str = 'gpt-4o',
     model_parameters: dict[str, typing.Any] | None = None,
     max_parallel_batches: int = 5,
@@ -1114,3 +1109,4 @@ llm_invoke(
 <ParamField path="messages" type="list[dict[str, str]] | None" optional={true} />
 <ParamField path="seed" type="int | None" optional={true} />
 <ParamField path="allow_tool_use" type="bool | None" optional={true} default="False" />
+

apps/opik-documentation/documentation/fern/openapi/opik.yaml

@@ -3651,6 +3651,36 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/ErrorMessage_Detail"
+    patch:
+      tags:
+      - Prompts
+      summary: Update prompt versions
+      description: |
+        Update one or more prompt versions.
+
+        Note: Prompt versions are immutable by design.
+        Only organizational properties, such as tags etc., can be updated.
+        Core properties like template and metadata cannot be modified after creation.
+
+        PATCH semantics:
+        - non-empty values update the field
+        - null values preserve existing field values (no change)
+        - empty values explicitly clear the field
+      operationId: updatePromptVersions
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/PromptVersionBatchUpdate"
+      responses:
+        "204":
+          description: No Content
+        "400":
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorMessage"
   /v1/private/prompts/{id}:
     get:
       tags:
@@ -3809,6 +3839,19 @@ paths:
           type: integer
           format: int32
           default: 10
+      - name: search
+        in: query
+        description: Search text to find in template or change description fields
+        schema:
+          type: string
+      - name: sorting
+        in: query
+        schema:
+          type: string
+      - name: filters
+        in: query
+        schema:
+          type: string
       responses:
         "200":
           description: OK
@@ -4949,6 +4992,47 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/ErrorMessage"
+  /v1/private/traces/threads/stats:
+    get:
+      tags:
+      - Traces
+      summary: Get trace thread stats
+      description: Get trace thread stats
+      operationId: getTraceThreadStats
+      parameters:
+      - name: project_id
+        in: query
+        schema:
+          type: string
+          format: uuid
+      - name: project_name
+        in: query
+        schema:
+          type: string
+      - name: filters
+        in: query
+        schema:
+          type: string
+      - name: from_time
+        in: query
+        schema:
+          type: string
+          description: Filter trace threads created from this time (ISO-8601 format).
+          format: date-time
+      - name: to_time
+        in: query
+        schema:
+          type: string
+          description: "Filter trace threads created up to this time (ISO-8601 format).\
+            \ If not provided, defaults to current time. Must be after 'from_time'."
+          format: date-time
+      responses:
+        "200":
+          description: Trace thread stats resource
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ProjectStats_Public"
   /v1/private/traces/{traceId}/comments/{commentId}:
     get:
       tags:
@@ -13018,6 +13102,12 @@ components:
           - jinja2
         change_description:
           type: string
+        tags:
+          uniqueItems: true
+          type: array
+          items:
+            minLength: 1
+            type: string
         variables:
           uniqueItems: true
           type: array
@@ -13112,6 +13202,12 @@ components:
           - jinja2
         change_description:
           type: string
+        tags:
+          uniqueItems: true
+          type: array
+          items:
+            minLength: 1
+            type: string
         variables:
           uniqueItems: true
           type: array
@@ -13229,6 +13325,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/PromptVersion_Public"
+        sortableBy:
+          type: array
+          items:
+            type: string
     PromptVersion_Public:
       required:
       - template
@@ -13259,6 +13359,12 @@ components:
           - jinja2
         change_description:
           type: string
+        tags:
+          uniqueItems: true
+          type: array
+          items:
+            minLength: 1
+            type: string
         template_structure:
           type: string
           readOnly: true
@@ -13367,10 +13473,65 @@ components:
           type: array
           items:
             type: string
+    PromptVersionBatchUpdate:
+      required:
+      - ids
+      - update
+      type: object
+      properties:
+        ids:
+          maxItems: 1000
+          minItems: 1
+          uniqueItems: true
+          type: array
+          description: IDs of prompt versions to update
+          items:
+            type: string
+            description: IDs of prompt versions to update
+            format: uuid
+        update:
+          $ref: "#/components/schemas/PromptVersionUpdate"
+        merge_tags:
+          type: boolean
+          description: |
+            Tag merge behavior:
+            - true: Add new tags to existing tags (union)
+            - false: Replace all existing tags with new tags (default behaviour if not provided)
+          default: false
+      description: |
+        Request to update one or more prompt versions.
+        Note: Prompt versions are immutable by design - only organizational properties (such as tags etc.) can be updated.
+    PromptVersionUpdate:
+      type: object
+      properties:
+        tags:
+          uniqueItems: true
+          type: array
+          description: |
+            Tags to set or merge with existing tags. Follows PATCH semantics:
+            - If merge_tags is true, these tags will be added to existing tags.
+            - If merge_tags is false, these tags will replace all existing tags.
+            - null: preserve existing tags (no change).
+            - empty set: clear all tags merge_tags is false.
+          items:
+            minLength: 1
+            type: string
+            description: |
+              Tags to set or merge with existing tags. Follows PATCH semantics:
+              - If merge_tags is true, these tags will be added to existing tags.
+              - If merge_tags is false, these tags will replace all existing tags.
+              - null: preserve existing tags (no change).
+              - empty set: clear all tags merge_tags is false.
+      description: |
+        Update to apply to prompt versions.
+        Note: Prompt versions are immutable by design.
+        Only organizational properties (such as tags etc.) can be updated.
+        Core properties like template, metadata etc. cannot be modified after creation.
     ServiceTogglesConfig:
       required:
       - alertsEnabled
       - anthropicProviderEnabled
+      - collaboratorsTabEnabled
       - csvUploadEnabled
       - customllmProviderEnabled
       - dashboardsEnabled
@@ -13431,6 +13592,8 @@ components:
           type: boolean
         opikbuiltinProviderEnabled:
           type: boolean
+        collaboratorsTabEnabled:
+          type: boolean
     SpanBatchUpdate:
       required:
       - ids