fix(specs): use summary fields (#5645)

kai687 · millotp · web-flow · commit c286dce46f7a · 2025-11-20T13:24:49.000+01:00
Co-authored-by: Pierre Millot &lt;pierre.millot@algolia.com&gt;
diff --git a/scripts/pre-gen/generateOpenapitools.ts b/scripts/pre-gen/generateOpenapitools.ts
@@ -35,6 +35,7 @@ export async function generateOpenapitools(
         mode,
         ...additionalProperties,
       },
+      skipValidateSpec: true,
       'openapi-normalizer': {
         // if this is set to true, it causes a breaking change on PlatformWithNone, this can be removed in the next major
         SIMPLIFY_ONEOF_ANYOF_ENUM: false,
diff --git a/specs/abtesting-v3/spec.yml b/specs/abtesting-v3/spec.yml
@@ -4,9 +4,8 @@ externalDocs:
   description: A/B testing.
 info:
   title: A/B Testing API
+  summary: The Algolia A/B Testing API lets you manage your Algolia A/B tests to optimize your search experience
   description: |
-    The Algolia A/B Testing API lets you manage your Algolia A/B tests to optimize your search experience.
-
     ## Base URLs
 
     The base URLs for requests to the A/B testing API are:
diff --git a/specs/abtesting/spec.yml b/specs/abtesting/spec.yml
@@ -4,9 +4,8 @@ externalDocs:
   description: A/B testing.
 info:
   title: A/B Testing API
+  summary: The Algolia A/B Testing API lets you manage your Algolia A/B tests to optimize your search experience
   description: |
-    The Algolia A/B Testing API lets you manage your Algolia A/B tests to optimize your search experience.
-
     ## Base URLs
 
     The base URLs for requests to the A/B testing API are:
diff --git a/specs/advanced-personalization/spec.yml b/specs/advanced-personalization/spec.yml
@@ -1,9 +1,8 @@
 openapi: 3.0.2
 info:
   title: Advanced Personalization API
+  summary: The Advanced Personalization API lets you access user profiles built based on the behavior of your users on your website or app
   description: |
-    The Advanced Personalization API lets you access user profiles built based on the behavior of your users on your website or app.
-
     ## Client libraries
 
     Use Algolia's API clients and libraries to reliably integrate Algolia's APIs with your apps.
diff --git a/specs/analytics/spec.yml b/specs/analytics/spec.yml
@@ -4,9 +4,8 @@ externalDocs:
   description: Search analytics.
 info:
   title: Analytics API
+  summary: The Analytics API gives you access to metrics related to your Algolia search experience
   description: |
-    The Analytics API gives you access to metrics related to your Algolia search experience.
-
     ## Base URLs
 
     The base URLs for requests to the Analytics API are:
diff --git a/specs/composition/spec.yml b/specs/composition/spec.yml
@@ -1,9 +1,8 @@
 openapi: 3.0.2
 info:
   title: Composition API
+  summary: The Algolia Composition API lets you run composed search requests on your Compositions
   description: |
-    The Algolia Composition API lets you run composed search requests on your Compositions.
-
     ## Client libraries
 
     Use Algolia's API clients and libraries to reliably integrate Algolia's APIs with your apps.
diff --git a/specs/crawler/spec.yml b/specs/crawler/spec.yml
@@ -1,9 +1,8 @@
 openapi: 3.0.2
 info:
   title: Crawler API
+  summary: The Crawler API lets you manage and run your crawlers
   description: |
-    The Crawler API lets you manage and run your crawlers.
-
     ## Base URL
 
     The base URL for making requests to the Crawler API is:
diff --git a/specs/ingestion/spec.yml b/specs/ingestion/spec.yml
@@ -1,8 +1,8 @@
 openapi: 3.0.2
 info:
   title: Ingestion API
+  summary: The Ingestion API lets you connect third-party services and platforms with Algolia and schedule tasks to ingest your data
   description: |
-    The Ingestion API lets you connect third-party services and platforms with Algolia and schedule tasks to ingest your data.
     The Ingestion API powers the no-code [data connectors](https://dashboard.algolia.com/connectors).
 
     ## Base URLs
diff --git a/specs/insights/spec.yml b/specs/insights/spec.yml
@@ -1,8 +1,8 @@
 openapi: 3.0.2
 info:
   title: Insights API
+  summary: The Insights API lets you collect events related to your search and discovery experience
   description: |
-    The Insights API lets you collect events related to your search and discovery experience.
     Events represent user interactions with your app or website.
     They unlock powerful features, such as recommendations, personalization, smarter search results,
     and analytics that help you optimize your user experience.
diff --git a/specs/monitoring/spec.yml b/specs/monitoring/spec.yml
@@ -1,9 +1,8 @@
 openapi: 3.0.2
 info:
   title: Algolia Monitoring API
+  summary: The Monitoring API lets you check the status of your Algolia infrastructure
   description: |
-    The Monitoring API lets you check the status of your Algolia infrastructure.
-
     ## Base URLs
 
     The base URL for requests to the Monitoring API is:
diff --git a/specs/personalization/spec.yml b/specs/personalization/spec.yml
@@ -1,9 +1,8 @@
 openapi: 3.0.2
 info:
   title: Personalization API
+  summary: The Personalization API lets you access user profiles built from the personalization strategy
   description: |
-    The Personalization API lets you access user profiles built from the personalization strategy.
-
     ## Base URLs
 
     The base URLs for requests to the Personalization API are:
diff --git a/specs/query-suggestions/spec.yml b/specs/query-suggestions/spec.yml
@@ -1,8 +1,8 @@
 openapi: 3.0.2
 info:
   title: Query Suggestions API
+  summary: The Query Suggestions API lets you manage your Query Suggestions configurations
   description: |
-    The Query Suggestions API lets you manage your Query Suggestions configurations.
     Query Suggestions add new indices to your Algolia application with popular search queries, external suggestions, or facet values.
     In your user interface, you can query the Query Suggestions indices like regular indices and add [suggested searches](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/query-suggestions/js) to guide users and speed up their search.
 
diff --git a/specs/recommend/spec.yml b/specs/recommend/spec.yml
@@ -1,9 +1,8 @@
 openapi: 3.0.2
 info:
   title: Recommend API
+  summary: The Recommend API lets you retrieve recommendations from one of Algolia's AI recommendation models that you previously trained on your data
   description: |
-    The Recommend API lets you retrieve recommendations from one of Algolia's AI recommendation models that you previously trained on your data.
-
     ## Client libraries
 
     Use Algolia's API clients and libraries to reliably integrate Algolia's APIs with your apps.
diff --git a/specs/search/spec.yml b/specs/search/spec.yml
@@ -1,9 +1,8 @@
 openapi: 3.0.2
 info:
   title: Search API
+  summary: The Algolia Search API lets you search, configure, and manage your indices and records
   description: |
-    The Algolia Search API lets you search, configure, and manage your indices and records.
-
     ## Client libraries
 
     Use Algolia's API clients and libraries to reliably integrate Algolia's APIs with your apps.
