[ci]: update pinecone-api with latest specifications

Pinecone CI · Pinecone CI · commit 09a8260a77dc · 2025-06-04T17:15:07.000Z
Files/Directories Updated:
- 2024-04/data_2024-04.oas.yaml
- 2024-04/data_2024-04.proto
- 2024-07/control_2024-07.oas.yaml
- 2024-07/data_2024-07.oas.yaml
- 2024-10/db_data_2024-10.oas.yaml
- 2024-10/db_data_2024-10.proto
- 2024-10/inference_2024-10.oas.yaml
- 2025-01/db_data_2025-01.oas.yaml
- 2025-01/db_data_2025-01.proto
- 2025-01/inference_2025-01.oas.yaml
- 2025-04/db_data_2025-04.oas.yaml
- 2025-04/db_data_2025-04.proto
- 2025-04/inference_2025-04.oas.yaml
diff --git a/2024-04/data_2024-04.oas.yaml b/2024-04/data_2024-04.oas.yaml
@@ -550,8 +550,7 @@ components:
             year:
               $eq: 2019
           description: >-
-            The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata). You can use vector metadata to limit your
-            search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
+            The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
         includeValues:
           type: boolean
           example: true
diff --git a/2024-04/data_2024-04.proto b/2024-04/data_2024-04.proto
@@ -191,7 +191,7 @@ message QueryRequest {
     (google.api.field_behavior) = REQUIRED
   ];
 
-  // The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata). You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
+  // The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
   google.protobuf.Struct filter           = 3;
 
   // Indicates whether vector values are included in the response.
diff --git a/2024-07/control_2024-07.oas.yaml b/2024-07/control_2024-07.oas.yaml
@@ -941,7 +941,7 @@ paths:
       - Inference
       summary: Generate vectors
       description: |-
-        Generate vector embeddings for input data. This endpoint uses [Pinecone Inference](https://docs.pinecone.io/guides/index-data/indexing-overview#vector-embedding).        
+        Generate vector embeddings for input data. This endpoint uses Pinecone's [hosted embedding models](https://docs.pinecone.io/guides/index-data/create-an-index#embedding-models).        
       operationId: embed
       requestBody:
         description: Generate embeddings for inputs.
diff --git a/2024-07/data_2024-07.oas.yaml b/2024-07/data_2024-07.oas.yaml
@@ -544,7 +544,7 @@ components:
               - drama
             year:
               $eq: 2019
-          description: The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata). You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
+          description: The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
           type: object
         includeValues:
           example: true
diff --git a/2024-10/db_data_2024-10.oas.yaml b/2024-10/db_data_2024-10.oas.yaml
@@ -797,7 +797,7 @@ components:
               - drama
             year:
               $eq: 2019
-          description: The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata). You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
+          description: The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
           type: object
         includeValues:
           example: true
diff --git a/2024-10/db_data_2024-10.proto b/2024-10/db_data_2024-10.proto
@@ -191,7 +191,7 @@ message QueryRequest {
     (google.api.field_behavior) = REQUIRED
   ];
 
-  // The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata). You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
+  // The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
   google.protobuf.Struct filter           = 3;
 
   // Indicates whether vector values are included in the response.
diff --git a/2024-10/inference_2024-10.oas.yaml b/2024-10/inference_2024-10.oas.yaml
@@ -20,7 +20,7 @@ paths:
       - Inference
       summary: Generate vectors
       description: |-
-        Generate vector embeddings for input data. This endpoint uses [Pinecone Inference](https://docs.pinecone.io/guides/index-data/indexing-overview#vector-embedding).
+        Generate vector embeddings for input data. This endpoint uses Pinecone's [hosted embedding models](https://docs.pinecone.io/guides/index-data/create-an-index#embedding-models).
       operationId: embed
       requestBody:
         description: Generate embeddings for inputs.
diff --git a/2025-01/db_data_2025-01.oas.yaml b/2025-01/db_data_2025-01.oas.yaml
@@ -906,7 +906,7 @@ components:
               - drama
             year:
               $eq: 2019
-          description: The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata). You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
+          description: The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
           type: object
         includeValues:
           example: true
diff --git a/2025-01/db_data_2025-01.proto b/2025-01/db_data_2025-01.proto
@@ -188,7 +188,7 @@ message QueryRequest {
     (google.api.field_behavior) = REQUIRED
   ];
 
-  // The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata). You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
+  // The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
   google.protobuf.Struct filter           = 3;
 
   // Indicates whether vector values are included in the response.
diff --git a/2025-01/inference_2025-01.oas.yaml b/2025-01/inference_2025-01.oas.yaml
@@ -20,7 +20,7 @@ paths:
       - Inference
       summary: Generate vectors
       description: |-
-        Generate vector embeddings for input data. This endpoint uses [Pinecone Inference](https://docs.pinecone.io/guides/index-data/indexing-overview#vector-embedding).
+        Generate vector embeddings for input data. This endpoint uses Pinecone's [hosted embedding models](https://docs.pinecone.io/guides/index-data/create-an-index#embedding-models).
       operationId: embed
       requestBody:
         description: Generate embeddings for inputs.
diff --git a/2025-04/db_data_2025-04.oas.yaml b/2025-04/db_data_2025-04.oas.yaml
@@ -528,8 +528,11 @@ paths:
     get:
       tags:
       - Namespace Operations
-      summary: Get list of all namespaces
-      description: Get a list of all namespaces within an index.
+      summary: List namespaces
+      description: |-
+        Get a list of all [namespaces](https://docs.pinecone.io/guides/index-data/indexing-overview#namespaces) in a serverless index.
+        
+        Up to 100 namespaces are returned at a time by default, in sorted order (bitwise “C” collation). If the `limit` parameter is set, up to that number of namespaces are returned instead. Whenever there are additional namespaces to return, the response also includes a `pagination_token` that you can use to get the next batch of namespaces. When the response does not include a `pagination_token`, there are no more namespaces to return.
       operationId: listNamespacesOperation
       parameters:
       - in: query
@@ -570,7 +573,7 @@ paths:
       tags:
       - Namespace Operations
       summary: Describe a namespace
-      description: Describe a namespace within an index, showing the vector count within the namespace.
+      description: Describe a [namespace](https://docs.pinecone.io/guides/index-data/indexing-overview#namespaces) in a serverless index, including the total number of vectors in the namespace.
       operationId: describeNamespace
       parameters:
       - in: path
@@ -1044,7 +1047,7 @@ components:
               - drama
             year:
               $eq: 2019
-          description: The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata). You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
+          description: The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
           type: object
         includeValues:
           example: true
diff --git a/2025-04/db_data_2025-04.proto b/2025-04/db_data_2025-04.proto
@@ -188,7 +188,7 @@ message QueryRequest {
     (google.api.field_behavior) = REQUIRED
   ];
 
-  // The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata). You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
+  // The filter to apply. You can use vector metadata to limit your search. See [Understanding metadata](https://docs.pinecone.io/guides/index-data/indexing-overview#metadata).
   google.protobuf.Struct filter           = 3;
 
   // Indicates whether vector values are included in the response.
@@ -438,9 +438,11 @@ service VectorService {
     };
   }
 
-  // Get list of all namespaces
+  // List namespaces
   //
-  // Get a list of all namespaces within an index.
+  // Get a list of all [namespaces](https://docs.pinecone.io/guides/index-data/indexing-overview#namespaces) in a serverless index.
+  //      
+  // Up to 100 namespaces are returned at a time by default, in sorted order (bitwise “C” collation). If the `limit` parameter is set, up to that number of namespaces are returned instead. Whenever there are additional namespaces to return, the response also includes a `pagination_token` that you can use to get the next batch of namespaces. When the response does not include a `pagination_token`, there are no more namespaces to return.
   rpc ListNamespaces(ListNamespacesRequest) returns (ListNamespacesResponse) {
     option (google.api.http) = {
       get: "/namespaces"
@@ -449,7 +451,7 @@ service VectorService {
 
   // Describe a namespace
   //
-  // Describe a namespace within an index, showing the vector count within the namespace.
+  // Describe a [namespace](https://docs.pinecone.io/guides/index-data/indexing-overview#namespaces) in a serverless index, including the total number of vectors in the namespace.
   rpc DescribeNamespace(DescribeNamespaceRequest) returns (NamespaceDescription) {
     option (google.api.http) = {
       get: "/namespaces/{namespace}"
diff --git a/2025-04/inference_2025-04.oas.yaml b/2025-04/inference_2025-04.oas.yaml
@@ -20,7 +20,7 @@ paths:
       - Inference
       summary: Generate vectors
       description: |-
-        Generate vector embeddings for input data. This endpoint uses [Pinecone Inference](https://docs.pinecone.io/guides/index-data/indexing-overview#vector-embedding).
+        Generate vector embeddings for input data. This endpoint uses Pinecone's [hosted embedding models](https://docs.pinecone.io/guides/index-data/create-an-index#embedding-models).
       operationId: embed
       requestBody:
         description: Generate embeddings for inputs.
@@ -83,7 +83,7 @@ paths:
       - Inference
       summary: Rerank documents
       description: |-
-        Rerank documents according to their relevance to a query.
+        Rerank results according to their relevance to a query.
 
         For guidance and examples, see [Rerank results](https://docs.pinecone.io/guides/search/rerank-results).
       operationId: rerank
@@ -146,8 +146,11 @@ paths:
     get:
       tags:
       - Inference
-      summary: Get available models.
-      description: Get available models.
+      summary: List available models
+      description: |-
+        List the embedding and reranking models hosted by Pinecone. 
+        
+        You can use hosted models as an integrated part of Pinecone operations or for standalone embedding and reranking. For more details, see [Vector embedding](https://docs.pinecone.io/guides/index-data/indexing-overview#vector-embedding) and [Rerank results](https://docs.pinecone.io/guides/search/rerank-results).
       operationId: list_models
       parameters:
       - in: query
@@ -273,8 +276,11 @@ paths:
     get:
       tags:
       - Inference
-      summary: Get available model details.
-      description: Get model details.
+      summary: Describe a model
+      description: |-
+        Get a description of a model hosted by Pinecone. 
+        
+        You can use hosted models as an integrated part of Pinecone operations or for standalone embedding and reranking. For more details, see [Vector embedding](https://docs.pinecone.io/guides/index-data/indexing-overview#vector-embedding) and [Rerank results](https://docs.pinecone.io/guides/search/rerank-results).
       operationId: get_model
       parameters:
       - in: path
