fix(specs): Add title values to key oneOfs (#5581) (generated) [skip ci]

algolia-bot · gazconroy · Gary Conroy · algolia-bot · commit e24c89bb18bd · 2025-11-12T12:19:48.000Z
Co-authored-by: gazconroy &lt;gazconroyster@gmail.com&gt;
Co-authored-by: Gary Conroy &lt;gary.conroy@LON-M3P-GConroy.local&gt;
Co-authored-by: Pierre Millot &lt;pierre.millot@algolia.com&gt;
diff --git a/clients/algoliasearch-client-csharp/algoliasearch/Clients/CompositionClient.cs b/clients/algoliasearch-client-csharp/algoliasearch/Clients/CompositionClient.cs
@@ -469,7 +469,7 @@ MultipleBatchResponse MultipleBatch(
   );
 
   /// <summary>
-  /// Upsert a composition in the current Algolia application.
+  /// Update and insert a composition in the current Algolia application.
   /// </summary>
   ///
   /// Required API Key ACLs:
@@ -490,7 +490,7 @@ Task<TaskIDResponse> PutCompositionAsync(
   );
 
   /// <summary>
-  /// Upsert a composition in the current Algolia application.  (Synchronous version)
+  /// Update and insert a composition in the current Algolia application.  (Synchronous version)
   /// </summary>
   ///
   /// Required API Key ACLs:
diff --git a/clients/algoliasearch-client-dart/packages/client_composition/lib/src/api/composition_client.dart b/clients/algoliasearch-client-dart/packages/client_composition/lib/src/api/composition_client.dart
@@ -447,7 +447,7 @@ final class CompositionClient implements ApiClient {
     );
   }
 
-  /// Upsert a composition in the current Algolia application.
+  /// Update and insert a composition in the current Algolia application.
   ///
   /// Required API Key ACLs:
   ///   - editSettings
diff --git a/clients/algoliasearch-client-go/algolia/composition/api_composition.go b/clients/algoliasearch-client-go/algolia/composition/api_composition.go
diff --git a/clients/algoliasearch-client-java/algoliasearch/src/main/java/com/algolia/api/CompositionClient.java b/clients/algoliasearch-client-java/algoliasearch/src/main/java/com/algolia/api/CompositionClient.java
@@ -930,7 +930,7 @@ public CompletableFuture<MultipleBatchResponse> multipleBatchAsync(@Nonnull Batc
   }
 
   /**
-   * Upsert a composition in the current Algolia application.
+   * Update and insert a composition in the current Algolia application.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param composition (required)
@@ -947,7 +947,7 @@ public TaskIDResponse putComposition(
   }
 
   /**
-   * Upsert a composition in the current Algolia application.
+   * Update and insert a composition in the current Algolia application.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param composition (required)
@@ -958,7 +958,7 @@ public TaskIDResponse putComposition(@Nonnull String compositionID, @Nonnull Com
   }
 
   /**
-   * (asynchronously) Upsert a composition in the current Algolia application.
+   * (asynchronously) Update and insert a composition in the current Algolia application.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param composition (required)
@@ -984,7 +984,7 @@ public CompletableFuture<TaskIDResponse> putCompositionAsync(
   }
 
   /**
-   * (asynchronously) Upsert a composition in the current Algolia application.
+   * (asynchronously) Update and insert a composition in the current Algolia application.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param composition (required)
diff --git a/clients/algoliasearch-client-javascript/packages/composition/src/compositionClient.ts b/clients/algoliasearch-client-javascript/packages/composition/src/compositionClient.ts
@@ -560,7 +560,7 @@ export function createCompositionClient({
     },
 
     /**
-     * Upsert a composition in the current Algolia application.
+     * Update and insert a composition in the current Algolia application.
      *
      * Required API Key ACLs:
      *  - editSettings
diff --git a/clients/algoliasearch-client-kotlin/client/src/commonMain/kotlin/com/algolia/client/api/CompositionClient.kt b/clients/algoliasearch-client-kotlin/client/src/commonMain/kotlin/com/algolia/client/api/CompositionClient.kt
@@ -330,7 +330,7 @@ public class CompositionClient(
   }
 
   /**
-   * Upsert a composition in the current Algolia application.
+   * Update and insert a composition in the current Algolia application.
    *
    * Required API Key ACLs:
    * - editSettings
diff --git a/clients/algoliasearch-client-php/lib/Api/CompositionClient.php b/clients/algoliasearch-client-php/lib/Api/CompositionClient.php
@@ -590,7 +590,7 @@ public function multipleBatch($batchParams, $requestOptions = [])
     }
 
     /**
-     * Upsert a composition in the current Algolia application.
+     * Update and insert a composition in the current Algolia application.
      *
      * Required API Key ACLs:
      *  - editSettings
diff --git a/clients/algoliasearch-client-python/algoliasearch/composition/client.py b/clients/algoliasearch-client-python/algoliasearch/composition/client.py
@@ -939,7 +939,7 @@ async def put_composition_with_http_info(
         request_options: Optional[Union[dict, RequestOptions]] = None,
     ) -> ApiResponse[str]:
         """
-        Upsert a composition in the current Algolia application.
+        Update and insert a composition in the current Algolia application.
 
         Required API Key ACLs:
           - editSettings
@@ -987,7 +987,7 @@ async def put_composition(
         request_options: Optional[Union[dict, RequestOptions]] = None,
     ) -> TaskIDResponse:
         """
-        Upsert a composition in the current Algolia application.
+        Update and insert a composition in the current Algolia application.
 
         Required API Key ACLs:
           - editSettings
@@ -2285,7 +2285,7 @@ def put_composition_with_http_info(
         request_options: Optional[Union[dict, RequestOptions]] = None,
     ) -> ApiResponse[str]:
         """
-        Upsert a composition in the current Algolia application.
+        Update and insert a composition in the current Algolia application.
 
         Required API Key ACLs:
           - editSettings
@@ -2333,7 +2333,7 @@ def put_composition(
         request_options: Optional[Union[dict, RequestOptions]] = None,
     ) -> TaskIDResponse:
         """
-        Upsert a composition in the current Algolia application.
+        Update and insert a composition in the current Algolia application.
 
         Required API Key ACLs:
           - editSettings
diff --git a/clients/algoliasearch-client-ruby/lib/algolia/api/composition_client.rb b/clients/algoliasearch-client-ruby/lib/algolia/api/composition_client.rb
@@ -595,7 +595,7 @@ def multiple_batch(batch_params, request_options = {})
       )
     end
 
-    # Upsert a composition in the current Algolia application.
+    # Update and insert a composition in the current Algolia application.
     #
     # Required API Key ACLs:
     #   - editSettings
@@ -635,7 +635,7 @@ def put_composition_with_http_info(composition_id, composition, request_options
       @api_client.call_api(:PUT, path, new_options)
     end
 
-    # Upsert a composition in the current Algolia application.
+    # Update and insert a composition in the current Algolia application.
     #
     # Required API Key ACLs:
     #   - editSettings
diff --git a/clients/algoliasearch-client-scala/src/main/scala/algoliasearch/api/CompositionClient.scala b/clients/algoliasearch-client-scala/src/main/scala/algoliasearch/api/CompositionClient.scala
@@ -365,7 +365,7 @@ class CompositionClient(
     execute[MultipleBatchResponse](request, requestOptions)
   }
 
-  /** Upsert a composition in the current Algolia application.
+  /** Update and insert a composition in the current Algolia application.
     *
     * Required API Key ACLs:
     *   - editSettings
diff --git a/clients/algoliasearch-client-swift/Sources/Composition/CompositionClient.swift b/clients/algoliasearch-client-swift/Sources/Composition/CompositionClient.swift
@@ -802,7 +802,7 @@ open class CompositionClient {
         return body
     }
 
-    // Upsert a composition in the current Algolia application.
+    // Update and insert a composition in the current Algolia application.
     // Required API Key ACLs:
     //  - editSettings
     //
diff --git a/docs/bundled/abtesting-v3.json b/docs/bundled/abtesting-v3.json
@@ -1340,9 +1340,11 @@
       "AddABTestsVariant": {
         "oneOf": [
           {
+            "title": "Variant",
             "$ref": "#/components/schemas/abTestsVariant"
           },
           {
+            "title": "Variant with search parameters",
             "$ref": "#/components/schemas/abTestsVariantSearchParams"
           }
         ]
diff --git a/docs/bundled/abtesting-v3.yml b/docs/bundled/abtesting-v3.yml
@@ -3844,8 +3844,10 @@ components:
         - $ref: '#/components/schemas/customSearchParams'
     AddABTestsVariant:
       oneOf:
-        - $ref: '#/components/schemas/abTestsVariant'
-        - $ref: '#/components/schemas/abTestsVariantSearchParams'
+        - title: Variant
+          $ref: '#/components/schemas/abTestsVariant'
+        - title: Variant with search parameters
+          $ref: '#/components/schemas/abTestsVariantSearchParams'
     createMetric:
       type: object
       description: Defines a metric to be retrieved during an A/B test.
diff --git a/docs/bundled/abtesting.json b/docs/bundled/abtesting.json
@@ -1341,9 +1341,11 @@
       "AddABTestsVariant": {
         "oneOf": [
           {
+            "title": "Variant",
             "$ref": "#/components/schemas/abTestsVariant"
           },
           {
+            "title": "Variant with search parameters",
             "$ref": "#/components/schemas/abTestsVariantSearchParams"
           }
         ]
diff --git a/docs/bundled/abtesting.yml b/docs/bundled/abtesting.yml
@@ -3355,8 +3355,10 @@ components:
         - $ref: '#/components/schemas/customSearchParams'
     AddABTestsVariant:
       oneOf:
-        - $ref: '#/components/schemas/abTestsVariant'
-        - $ref: '#/components/schemas/abTestsVariantSearchParams'
+        - title: Variant
+          $ref: '#/components/schemas/abTestsVariant'
+        - title: Variant with search parameters
+          $ref: '#/components/schemas/abTestsVariantSearchParams'
     taskID:
       type: integer
       format: int64
diff --git a/docs/bundled/composition.json b/docs/bundled/composition.json
@@ -480,8 +480,8 @@
         "x-acl": [
           "editSettings"
         ],
-        "summary": "Upsert a composition",
-        "description": "Upsert a composition in the current Algolia application.\n",
+        "summary": "Update and insert (upsert) a composition",
+        "description": "Update and insert a composition in the current Algolia application.\n",
         "parameters": [
           {
             "$ref": "#/components/parameters/compositionID"
@@ -3964,9 +3964,11 @@
       "batchCompositionAction": {
         "oneOf": [
           {
+            "title": "Upsert (update and insert)",
             "$ref": "#/components/schemas/composition"
           },
           {
+            "title": "Delete",
             "$ref": "#/components/schemas/deleteCompositionAction"
           }
         ]
@@ -4115,9 +4117,11 @@
       "rulesBatchCompositionAction": {
         "oneOf": [
           {
+            "title": "Upsert (update and insert)",
             "$ref": "#/components/schemas/compositionRule"
           },
           {
+            "title": "Delete",
             "$ref": "#/components/schemas/deleteCompositionRuleAction"
           }
         ]
diff --git a/docs/bundled/composition.yml b/docs/bundled/composition.yml
@@ -2434,9 +2434,9 @@ paths:
       operationId: putComposition
       x-acl:
         - editSettings
-      summary: Upsert a composition
+      summary: Update and insert (upsert) a composition
       description: |
-        Upsert a composition in the current Algolia application.
+        Update and insert a composition in the current Algolia application.
       parameters:
         - $ref: '#/components/parameters/compositionID'
       requestBody:
@@ -9133,8 +9133,10 @@ components:
         - objectID
     batchCompositionAction:
       oneOf:
-        - $ref: '#/components/schemas/composition'
-        - $ref: '#/components/schemas/deleteCompositionAction'
+        - title: Upsert (update and insert)
+          $ref: '#/components/schemas/composition'
+        - title: Delete
+          $ref: '#/components/schemas/deleteCompositionAction'
     ruleID:
       title: objectID
       type: string
@@ -9278,8 +9280,10 @@ components:
         - objectID
     rulesBatchCompositionAction:
       oneOf:
-        - $ref: '#/components/schemas/compositionRule'
-        - $ref: '#/components/schemas/deleteCompositionRuleAction'
+        - title: Upsert (update and insert)
+          $ref: '#/components/schemas/compositionRule'
+        - title: Delete
+          $ref: '#/components/schemas/deleteCompositionRuleAction'
     parameters_query:
       type: string
       description: Search query for rules.
diff --git a/docs/bundled/ingestion.json b/docs/bundled/ingestion.json
@@ -5172,6 +5172,7 @@
         ]
       },
       "StreamingInput": {
+        "title": "Streaming input",
         "type": "object",
         "additionalProperties": false,
         "description": "Input for a `streaming` task whose source is of type `ga4BigqueryExport` and for which extracted data is continuously streamed.",
@@ -5219,6 +5220,7 @@
         ]
       },
       "DockerStreamsInput": {
+        "title": "Docker streams",
         "description": "The selected streams of an airbyte connector.",
         "type": "object",
         "properties": {
@@ -5288,6 +5290,7 @@
         ]
       },
       "ShopifyInput": {
+        "title": "Shopify input",
         "type": "object",
         "additionalProperties": false,
         "description": "Represents the required elements of the task input when using a `shopify` source.",
@@ -5957,6 +5960,7 @@
         "description": "It is deprecated. Use the `input` field with proper `type` instead to specify the transformation code."
       },
       "TransformationCode": {
+        "title": "Code",
         "type": "object",
         "additionalProperties": false,
         "description": "Input for a transformation that contains the source code of the transformation.",
@@ -5975,6 +5979,7 @@
         "description": "A step in a no-code transformation."
       },
       "TransformationNoCode": {
+        "title": "No-code",
         "type": "object",
         "additionalProperties": false,
         "description": "Input for a no-code transformation that contains a series of steps.",
diff --git a/docs/bundled/ingestion.yml b/docs/bundled/ingestion.yml
@@ -17779,6 +17779,7 @@ components:
         - format
         - actions
     StreamingInput:
+      title: Streaming input
       type: object
       additionalProperties: false
       description: >-
@@ -17814,6 +17815,7 @@ components:
         - name
         - syncMode
     DockerStreamsInput:
+      title: Docker streams
       description: The selected streams of an airbyte connector.
       type: object
       properties:
@@ -17862,6 +17864,7 @@ components:
         - currencies
         - locales
     ShopifyInput:
+      title: Shopify input
       type: object
       additionalProperties: false
       description: >-
@@ -18338,6 +18341,7 @@ components:
         It is deprecated. Use the `input` field with proper `type` instead to
         specify the transformation code.
     TransformationCode:
+      title: Code
       type: object
       additionalProperties: false
       description: >-
@@ -18353,6 +18357,7 @@ components:
       type: object
       description: A step in a no-code transformation.
     TransformationNoCode:
+      title: No-code
       type: object
       additionalProperties: false
       description: Input for a no-code transformation that contains a series of steps.
diff --git a/docs/bundled/recommend.json b/docs/bundled/recommend.json
@@ -3291,6 +3291,7 @@
       },
       "trendingFacetHit": {
         "type": "object",
+        "title": "Trending facet hit",
         "description": "Trending facet hit.",
         "required": [
           "facetName",
diff --git a/docs/bundled/recommend.yml b/docs/bundled/recommend.yml
@@ -5904,6 +5904,7 @@ components:
         - objectID
     trendingFacetHit:
       type: object
+      title: Trending facet hit
       description: Trending facet hit.
       required:
         - facetName
diff --git a/specs/bundled/abtesting-v3.yml b/specs/bundled/abtesting-v3.yml
diff --git a/specs/bundled/abtesting.yml b/specs/bundled/abtesting.yml
diff --git a/specs/bundled/algoliasearch.yml b/specs/bundled/algoliasearch.yml
diff --git a/specs/bundled/composition.yml b/specs/bundled/composition.yml
diff --git a/specs/bundled/ingestion.yml b/specs/bundled/ingestion.yml
diff --git a/specs/bundled/recommend.yml b/specs/bundled/recommend.yml

Original file line number	Diff line number	Diff line change
`@@ -447,7 +447,7 @@ final class CompositionClient implements ApiClient {`
`447`	`447`	`);`
`448`	`448`	`}`
`449`	`449`
`450`		`- /// Upsert a composition in the current Algolia application.`
	`450`	`+ /// Update and insert a composition in the current Algolia application.`
`451`	`451`	`///`
`452`	`452`	`/// Required API Key ACLs:`
`453`	`453`	`/// - editSettings`
Original file line number	Diff line number	Diff line change
`@@ -930,7 +930,7 @@ public CompletableFuture<MultipleBatchResponse> multipleBatchAsync(@Nonnull Batc`
`930`	`930`	`}`
`931`	`931`
`932`	`932`	`/**`
`933`		`- * Upsert a composition in the current Algolia application.`
	`933`	`+ * Update and insert a composition in the current Algolia application.`
`934`	`934`	`*`
`935`	`935`	`* @param compositionID Unique Composition ObjectID. (required)`
`936`	`936`	`* @param composition (required)`
`@@ -947,7 +947,7 @@ public TaskIDResponse putComposition(`
`947`	`947`	`}`
`948`	`948`
`949`	`949`	`/**`
`950`		`- * Upsert a composition in the current Algolia application.`
	`950`	`+ * Update and insert a composition in the current Algolia application.`
`951`	`951`	`*`
`952`	`952`	`* @param compositionID Unique Composition ObjectID. (required)`
`953`	`953`	`* @param composition (required)`
`@@ -958,7 +958,7 @@ public TaskIDResponse putComposition(@Nonnull String compositionID, @Nonnull Com`
`958`	`958`	`}`
`959`	`959`
`960`	`960`	`/**`
`961`		`- * (asynchronously) Upsert a composition in the current Algolia application.`
	`961`	`+ * (asynchronously) Update and insert a composition in the current Algolia application.`
`962`	`962`	`*`
`963`	`963`	`* @param compositionID Unique Composition ObjectID. (required)`
`964`	`964`	`* @param composition (required)`
`@@ -984,7 +984,7 @@ public CompletableFuture<TaskIDResponse> putCompositionAsync(`
`984`	`984`	`}`
`985`	`985`
`986`	`986`	`/**`
`987`		`- * (asynchronously) Upsert a composition in the current Algolia application.`
	`987`	`+ * (asynchronously) Update and insert a composition in the current Algolia application.`
`988`	`988`	`*`
`989`	`989`	`* @param compositionID Unique Composition ObjectID. (required)`
`990`	`990`	`* @param composition (required)`
Original file line number	Diff line number	Diff line change
`@@ -560,7 +560,7 @@ export function createCompositionClient({`
`560`	`560`	`},`
`561`	`561`
`562`	`562`	`/**`
`563`		`- * Upsert a composition in the current Algolia application.`
	`563`	`+ * Update and insert a composition in the current Algolia application.`
`564`	`564`	`*`
`565`	`565`	`* Required API Key ACLs:`
`566`	`566`	`* - editSettings`
Original file line number	Diff line number	Diff line change
`@@ -330,7 +330,7 @@ public class CompositionClient(`
`330`	`330`	`}`
`331`	`331`
`332`	`332`	`/**`
`333`		`- * Upsert a composition in the current Algolia application.`
	`333`	`+ * Update and insert a composition in the current Algolia application.`
`334`	`334`	`*`
`335`	`335`	`* Required API Key ACLs:`
`336`	`336`	`* - editSettings`
Original file line number	Diff line number	Diff line change
`@@ -590,7 +590,7 @@ public function multipleBatch($batchParams, $requestOptions = [])`
`590`	`590`	`}`
`591`	`591`
`592`	`592`	`/**`
`593`		`- * Upsert a composition in the current Algolia application.`
	`593`	`+ * Update and insert a composition in the current Algolia application.`
`594`	`594`	`*`
`595`	`595`	`* Required API Key ACLs:`
`596`	`596`	`* - editSettings`
Original file line number	Diff line number	Diff line change
`@@ -595,7 +595,7 @@ def multiple_batch(batch_params, request_options = {})`
`595`	`595`	`)`
`596`	`596`	`end`
`597`	`597`
`598`		`- # Upsert a composition in the current Algolia application.`
	`598`	`+ # Update and insert a composition in the current Algolia application.`
`599`	`599`	`#`
`600`	`600`	`# Required API Key ACLs:`
`601`	`601`	`# - editSettings`
`@@ -635,7 +635,7 @@ def put_composition_with_http_info(composition_id, composition, request_options`
`635`	`635`	`@api_client.call_api(:PUT, path, new_options)`
`636`	`636`	`end`
`637`	`637`
`638`		`- # Upsert a composition in the current Algolia application.`
	`638`	`+ # Update and insert a composition in the current Algolia application.`
`639`	`639`	`#`
`640`	`640`	`# Required API Key ACLs:`
`641`	`641`	`# - editSettings`
Original file line number	Diff line number	Diff line change
`@@ -365,7 +365,7 @@ class CompositionClient(`
`365`	`365`	`execute[MultipleBatchResponse](request, requestOptions)`
`366`	`366`	`}`
`367`	`367`
`368`		`- /** Upsert a composition in the current Algolia application.`
	`368`	`+ /** Update and insert a composition in the current Algolia application.`
`369`	`369`	`*`
`370`	`370`	`* Required API Key ACLs:`
`371`	`371`	`* - editSettings`