@relevanceai/sdk 1.0.0 → 1.5.0

package/dist-types/generated/_VectorApiSchemaTypes.d.ts

@@ -164,6 +164,10 @@ export interface paths {
          *         {'field' : 'price', 'filter_type' : 'numeric', "condition":">=", "condition_value":90}
          * 7. **"ids"**: for filtering by document ids.
          *         {'field' : 'ids', 'filter_type' : 'ids', "condition":"==", "condition_value":["1", "10"]}
+         * 8. **"or"**: for filtering with multiple conditions
+         *         {'filter_type' : 'or',
+         * "condition_value": [{'field' : 'price', 'filter_type' : 'numeric', "condition":"<=", "condition_value":90},
+         * {'field' : 'price', 'filter_type' : 'numeric', "condition":">=", "condition_value":150}]}
          *
          * These are the available conditions:
          *
@@ -247,6 +251,29 @@ export interface paths {
         /** Get status of a collection level job. Whether its starting, running, failed or finished. */
         get: operations["tasks_status_api_datasets__dataset_id__tasks__task_id__status_get"];
     };
+    "/datasets/{dataset_id}/vectorize": {
+        /** Queue the encoding of a dataset using the method given by model_id. */
+        post: operations["encode_by_model_api_datasets__dataset_id__vectorize_post"];
+    };
+    "/datasets/{dataset_id}/task_status": {
+        /**
+         * Check the status of an existing encoding task on the given dataset.
+         *
+         * The required task_id was returned in the original encoding request
+         * such as /vectorize.
+         */
+        get: operations["task_status_by_model_api_datasets__dataset_id__task_status_get"];
+    };
+    "/datasets/{dataset_id}/tasks": {
+        /**
+         * List the tasks being encoded for the dataset_id that
+         * you are authorized to read.
+         *
+         * If dataset_id is the wildcard "*" then all tasks for the
+         * user project are listed.
+         */
+        get: operations["list_tasks_api_datasets__dataset_id__tasks_get"];
+    };
     "/services/search/vector": {
         /**
          * Allows you to leverage vector similarity search to create a semantic search engine.
@@ -604,6 +631,17 @@ export interface paths {
          * - "groupby" is the fields you want to split the data into. These are the available groupby types:
          *     - category" : groupby a field that is a category
          *     - numeric: groupby a field that is a numeric
+         *     - wordcloud: groupby the words. You can also additionally include stop words in your aggregation
+         *     if you add `remove_words` as a field.
+         *
+         *     {
+         *         "name": "wordcloud_research",
+         *         "field": "title",
+         *         "agg": "wordcloud",
+         *         "remove_words": ["learning"]
+         *     }
+         *
+         *
          * - "metrics" is the fields you want to metrics you want to calculate in each of those, every aggregation includes a frequency metric. These are the available metric types:
          *     - "avg", "max", "min", "sum", "cardinality"
          *
@@ -627,28 +665,60 @@ export interface paths {
         post: operations["aggregate_v2_api_services_aggregate_aggregate_post"];
     };
     "/services/cluster/centroids/list": {
-        /** Retrieve the cluster centroid */
+        /** Retrieves a list of cluster centroids */
         get: operations["cluster_centroids_api_services_cluster_centroids_list_get"];
+        /** Retrieves a list of cluster centroids */
+        post: operations["cluster_centroids_api_v2_services_cluster_centroids_list_post"];
     };
     "/services/cluster/centroids/get": {
         /** Retrieve the cluster centroids by IDs */
         get: operations["cluster_centroids_get_api_services_cluster_centroids_get_get"];
+        /** Retrieve the cluster centroids by IDs */
+        post: operations["cluster_centroids_get_api_services_cluster_centroids_get_post"];
     };
     "/services/cluster/centroids/insert": {
         /** Insert your own cluster centroids for it to be used in approximate search settings and cluster aggregations. */
-        post: operations["insert_cluster_centroids_api_services_cluster_centroids_insert_post"];
+        post: operations["insert_cluster_centroids_2_api_services_cluster_centroids_insert_post"];
+    };
+    "/services/cluster/centroids/update": {
+        /** Update a centroid by ID */
+        post: operations["update_centroids_api_v2_services_cluster_centroids_update_post"];
+    };
+    "/services/cluster/centroids/{centroid_id}/delete": {
+        /** Delete a centroid by ID */
+        get: operations["delete_centroids_api_services_cluster_centroids__centroid_id__delete_get"];
+        /** Delete a centroid by ID */
+        post: operations["delete_centroids_api_services_cluster_centroids__centroid_id__delete_post"];
+    };
+    "/services/cluster/centroids/delete": {
+        /** Delete centroids by dataset ID, vector field and alias */
+        post: operations["cluster_centroids_delete_api_services_cluster_centroids_delete_post"];
     };
     "/services/cluster/centroids/documents": {
         /** Retrieve the cluster centroids by IDs */
         post: operations["cluster_centroids_get_api_services_cluster_centroids_documents_post"];
     };
+    "/services/cluster/centroids/metadata": {
+        /** Retrieves metadata about a dataset. notably description, data source, etc */
+        get: operations["centroids_metadata_get_api_services_cluster_centroids_metadata_get"];
+        /** You can store the metadata about your cluster here. */
+        post: operations["centroids_metadata_post_api_v2_services_cluster_centroids_metadata_post"];
+    };
+    "/services/cluster/centroids/list_closest_to_center": {
+        /** List of documents closest from the centre. */
+        post: operations["centroids_list_closest_to_center_v2_services_cluster_centroids_list_closest_to_center_post"];
+    };
+    "/services/cluster/centroids/list_furthest_from_center": {
+        /** List of documents from from the centre */
+        post: operations["centroids_list_furthest_from_center_v2_services_cluster_centroids_list_furthest_from_center_post"];
+    };
     "/services/cluster/aggregate": {
         /**
          * Takes an aggregation query and gets the aggregate of each cluster in a collection. This helps you interpret each cluster and what is in them.
          *
          * Only can be used after a vector field has been clustered with /cluster.
          */
-        post: operations["cluster_aggregate_api_services_cluster_aggregate_post"];
+        post: operations["cluster_aggregate_api_v2_services_cluster_aggregate_post"];
     };
     "/services/cluster/facets": {
         /**
@@ -656,7 +726,13 @@ export interface paths {
          *
          * Only can be used after a vector field has been clustered with /cluster.
          */
-        get: operations["cluster_facets_api_services_cluster_facets_get"];
+        get: operations["advanced_cluster_facets_api_services_cluster_facets_get"];
+    };
+    "/services/cluster/list": {
+        /** Get a list of cluster IDs based on the relevant information */
+        get: operations["cluster_list_services_cluster_list_get"];
+        /** Get a list of cluster IDs */
+        post: operations["cluster_list_multi_services_cluster_list_post"];
     };
     "/services/tagger/tag": {
         /** Tag documents or vectors. */
@@ -986,7 +1062,7 @@ export interface components {
             dataset_id: string;
             /** Query for advance search that allows for multiple vector and field querying. */
             multivector_query: components["schemas"]["VectorQuery"][];
-            /** Field that the array of chunked documents are. */
+            /** Field where the array of chunked documents are. */
             chunk_field?: string;
             /** Scoring method for determining for ranking between document chunks. */
             chunk_scoring?: string;
@@ -1322,18 +1398,139 @@ export interface components {
             /** Similarity Metric, choose from ['cosine', 'l1', 'l2', 'dp'] */
             similarity_metric?: string;
         };
-        /** Base class for all abstractmodels */
-        CentroidInsertBody: {
-            /** The dataset ID. */
+        /** Adds support for multi vector field clustering */
+        CentroidInsertBodyV2: {
+            /** Unique name of dataset */
             dataset_id: string;
             /** Cluster centers with the key being the index number */
             cluster_centers: {
                 [key: string]: unknown;
+            }[];
+            /** The vector field to search in. It can either be an array of strings (automatically equally weighted) (e.g. ['check_vector_', 'yellow_vector_']) or it is a dictionary mapping field to float where the weighting is explicitly specified (e.g. {'check_vector_': 0.2, 'yellow_vector_': 0.5}) */
+            vector_fields: unknown[];
+            /** Include the inserted IDs in the response */
+            include_inserted_ids?: boolean;
+            /** Alias used to name a vector field. Belongs in field_{alias}_vector_ */
+            alias?: string;
+        };
+        /** Base class for all abstractmodels */
+        CentroidMetadataV2: {
+            /** Unique name of dataset */
+            dataset_id: string;
+            /** Description for a metadata */
+            metadata?: {
+                [key: string]: unknown;
+            };
+            /** The vector field to search in. It can either be an array of strings (automatically equally weighted) (e.g. ['check_vector_', 'yellow_vector_']) or it is a dictionary mapping field to float where the weighting is explicitly specified (e.g. {'check_vector_': 0.2, 'yellow_vector_': 0.5}) */
+            vector_fields: unknown[];
+            /** Alias used to name a vector field. Belongs in field_{alias}_vector_ */
+            alias?: string;
+        };
+        /** Base class for all abstractmodels */
+        CentroidUpdateBodyV2: {
+            /** Unique name of dataset */
+            dataset_id: string;
+            /** The vector field to search in. It can either be an array of strings (automatically equally weighted) (e.g. ['check_vector_', 'yellow_vector_']) or it is a dictionary mapping field to float where the weighting is explicitly specified (e.g. {'check_vector_': 0.2, 'yellow_vector_': 0.5}) */
+            vector_fields: unknown[];
+            /** Alias used to name a vector field. Belongs in field_{alias}_vector_ */
+            alias?: string;
+            /** ID of a centroid in a dataset. */
+            id: string;
+            /** A dictionary to edit and add fields to a document. */
+            update: {
+                [key: string]: unknown;
             };
-            /** Clustered vector field */
-            vector_field: boolean;
+        };
+        /** Base class for all abstractmodels */
+        CentroidsClosestToCenterV2: {
+            /** Unique name of dataset */
+            dataset_id: string;
+            /** The vector field to search in. It can either be an array of strings (automatically equally weighted) (e.g. ['check_vector_', 'yellow_vector_']) or it is a dictionary mapping field to float where the weighting is explicitly specified (e.g. {'check_vector_': 0.2, 'yellow_vector_': 0.5}) */
+            vector_fields: unknown[];
+            /** Alias used to name a vector field. Belongs in field_{alias}_vector_ */
+            alias?: string;
+            /** List of cluster IDs */
+            cluster_ids?: string[];
+            /** Centroid vector field */
+            centroid_vector_field?: string[];
+            /** Fields to include in the search results, empty array/list means all fields. */
+            select_fields?: string[];
+            /** Used for approximate search to speed up search. The higher the number, faster the search but potentially less accurate. */
+            approx?: number;
+            /** Whether to sum the multiple vectors similarity search score as 1 or seperate */
+            sum_fields?: boolean;
+            /** Size of each page of results */
+            page_size?: number;
+            /** Page of the results */
+            page?: number;
+            /** Similarity Metric, choose from ['cosine', 'l1', 'l2', 'dp'] */
+            similarity_metric?: string;
+            /** Query for filtering the search results */
+            filters?: unknown[];
+            /** Fields to include in the facets, if [] then all */
+            facets?: unknown[];
+            /** Minimum score for similarity metric */
+            min_score?: number;
+            /** Include vectors in the search results */
+            include_vector?: boolean;
+            /** Include the total count of results in the search results */
+            include_count?: boolean;
+            /** Include facets in the search results */
+            include_facets?: boolean;
+        };
+        /** Base class for all abstractmodels */
+        CentroidsFurthestFromCenterV2: {
+            /** Unique name of dataset */
+            dataset_id: string;
+            /** The vector field to search in. It can either be an array of strings (automatically equally weighted) (e.g. ['check_vector_', 'yellow_vector_']) or it is a dictionary mapping field to float where the weighting is explicitly specified (e.g. {'check_vector_': 0.2, 'yellow_vector_': 0.5}) */
+            vector_fields: unknown[];
+            /** Alias used to name a vector field. Belongs in field_{alias}_vector_ */
+            alias?: string;
+            /** List of cluster IDs */
+            cluster_ids?: string[];
+            /** Centroid vector field */
+            centroid_vector_field?: string[];
+            /** Fields to include in the search results, empty array/list means all fields. */
+            select_fields?: string[];
+            /** Used for approximate search to speed up search. The higher the number, faster the search but potentially less accurate. */
+            approx?: number;
+            /** Whether to sum the multiple vectors similarity search score as 1 or seperate */
+            sum_fields?: boolean;
+            /** Size of each page of results */
+            page_size?: number;
+            /** Page of the results */
+            page?: number;
+            /** Similarity Metric, choose from ['cosine', 'l1', 'l2', 'dp'] */
+            similarity_metric?: string;
+            /** Query for filtering the search results */
+            filters?: unknown[];
+            /** Fields to include in the facets, if [] then all */
+            facets?: unknown[];
+            /** Minimum score for similarity metric */
+            min_score?: number;
+            /** Include vectors in the search results */
+            include_vector?: boolean;
+            /** Include the total count of results in the search results */
+            include_count?: boolean;
+            /** Include facets in the search results */
+            include_facets?: boolean;
+        };
+        /** Base class for all abstractmodels */
+        CentroidsGetV2: {
+            /** Unique name of dataset */
+            dataset_id: string;
+            /** List of cluster IDs */
+            cluster_ids: string[];
+            /** The vector field where a clustering task was run. */
+            vector_fields: unknown[];
             /** Alias is used to name a cluster */
             alias?: string;
+            /** Size of each page of results */
+            page_size?: number;
+            /** Cursor to paginate the document retrieval */
+            cursor?: string;
+            /** Include vectors in the search results */
+            include_vector?: boolean;
         };
         /** Base class for all abstractmodels */
         ChunkSearchQuery: {
@@ -1341,7 +1538,7 @@ export interface components {
             dataset_id: string;
             /** Query for advance search that allows for multiple vector and field querying. */
             multivector_query: components["schemas"]["VectorQuery"][];
-            /** Field that the array of chunked documents are. */
+            /** Field where the array of chunked documents are. */
             chunk_field?: string;
             /** Scoring method for determining for ranking between document chunks. */
             chunk_scoring?: string;
@@ -1384,7 +1581,7 @@ export interface components {
             count?: number;
         };
         /** Base class for all abstractmodels */
-        ClusterAggregateQueryCommons: {
+        ClusterAggregateQueryCommonsV2: {
             /** Unique name of dataset */
             dataset_id: string;
             /** Aggregation query to aggregate data */
@@ -1402,8 +1599,23 @@ export interface components {
             flatten?: boolean;
             /** Alias used to name a vector field. Belongs in field_{alias}_vector_ */
             alias?: string;
-            /** The vector field that was clustered on */
-            vector_field: string;
+            /** The vector field to search in. It can either be an array of strings (automatically equally weighted) (e.g. ['check_vector_', 'yellow_vector_']) or it is a dictionary mapping field to float where the weighting is explicitly specified (e.g. {'check_vector_': 0.2, 'yellow_vector_': 0.5}) */
+            vector_fields: string[];
+        };
+        /** Base class for all abstractmodels */
+        ClustercentroidsList: {
+            /** Unique name of dataset */
+            dataset_id: string;
+            /** The vector field where a clustering task was run. */
+            vector_fields: unknown[];
+            /** Alias is used to name a cluster */
+            alias?: string;
+            /** Size of each page of results */
+            page_size?: number;
+            /** Cursor to paginate the document retrieval */
+            cursor?: string;
+            /** Include vectors in the search results */
+            include_vector?: boolean;
         };
         /** Cluster Task */
         Clusterer: {
@@ -2209,6 +2421,23 @@ export interface components {
             vector: number[];
         };
         /** Base class for all abstractmodels */
+        VectorizeEncodeDataset: {
+            /** Fields to remove ['random_field', 'another_random_field']. Defaults to no removes */
+            fields?: string[];
+            /** Filters to run against */
+            filters?: unknown[];
+            /** If True, re-runs encoding on whole dataset. */
+            refresh?: boolean;
+            /** Alias used to name a vector field. Belongs in field_{alias}_vector_ */
+            alias?: string;
+            /** batch for each encoding. Change at your own risk. */
+            chunksize?: number;
+            /** The chunk field. If the chunk field is specified, the field to be encoded should not include the chunk field. */
+            chunk_field?: string;
+            /** Model ID to use for vectorizing (encoding.) */
+            model_id: string;
+        };
+        /** Base class for all abstractmodels */
         WordCloudModel: {
             /** Unique name of dataset */
             dataset_id: string;
@@ -2887,6 +3116,10 @@ export interface operations {
      *         {'field' : 'price', 'filter_type' : 'numeric', "condition":">=", "condition_value":90}
      * 7. **"ids"**: for filtering by document ids.
      *         {'field' : 'ids', 'filter_type' : 'ids', "condition":"==", "condition_value":["1", "10"]}
+     * 8. **"or"**: for filtering with multiple conditions
+     *         {'filter_type' : 'or',
+     * "condition_value": [{'field' : 'price', 'filter_type' : 'numeric', "condition":"<=", "condition_value":90},
+     * {'field' : 'price', 'filter_type' : 'numeric', "condition":">=", "condition_value":150}]}
      *
      * These are the available conditions:
      *
@@ -3447,6 +3680,104 @@ export interface operations {
             };
         };
     };
+    /** Queue the encoding of a dataset using the method given by model_id. */
+    encode_by_model_api_datasets__dataset_id__vectorize_post: {
+        parameters: {
+            path: {
+                dataset_id: string;
+            };
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["VectorizeEncodeDataset"];
+            };
+        };
+    };
+    /**
+     * Check the status of an existing encoding task on the given dataset.
+     *
+     * The required task_id was returned in the original encoding request
+     * such as /vectorize.
+     */
+    task_status_by_model_api_datasets__dataset_id__task_status_get: {
+        parameters: {
+            path: {
+                dataset_id: string;
+            };
+            query: {
+                /** The task ID of the earlier queued vectorize task */
+                task_id: string;
+            };
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    /**
+     * List the tasks being encoded for the dataset_id that
+     * you are authorized to read.
+     *
+     * If dataset_id is the wildcard "*" then all tasks for the
+     * user project are listed.
+     */
+    list_tasks_api_datasets__dataset_id__tasks_get: {
+        parameters: {
+            path: {
+                dataset_id: string;
+            };
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     /**
      * Allows you to leverage vector similarity search to create a semantic search engine.
      * Powerful features of VecDB vector search:
@@ -4067,6 +4398,17 @@ export interface operations {
      * - "groupby" is the fields you want to split the data into. These are the available groupby types:
      *     - category" : groupby a field that is a category
      *     - numeric: groupby a field that is a numeric
+     *     - wordcloud: groupby the words. You can also additionally include stop words in your aggregation
+     *     if you add `remove_words` as a field.
+     *
+     *     {
+     *         "name": "wordcloud_research",
+     *         "field": "title",
+     *         "agg": "wordcloud",
+     *         "remove_words": ["learning"]
+     *     }
+     *
+     *
      * - "metrics" is the fields you want to metrics you want to calculate in each of those, every aggregation includes a frequency metric. These are the available metric types:
      *     - "avg", "max", "min", "sum", "cardinality"
      *
@@ -4114,7 +4456,7 @@ export interface operations {
             };
         };
     };
-    /** Retrieve the cluster centroid */
+    /** Retrieves a list of cluster centroids */
     cluster_centroids_api_services_cluster_centroids_list_get: {
         parameters: {
             query: {
@@ -4151,23 +4493,9 @@ export interface operations {
             };
         };
     };
-    /** Retrieve the cluster centroids by IDs */
-    cluster_centroids_get_api_services_cluster_centroids_get_get: {
+    /** Retrieves a list of cluster centroids */
+    cluster_centroids_api_v2_services_cluster_centroids_list_post: {
         parameters: {
-            query: {
-                /** Unique name of dataset */
-                dataset_id: string;
-                /** List of cluster IDs */
-                cluster_ids: string[];
-                /** The vector field where a clustering task was run. */
-                vector_field: string;
-                /** Alias is used to name a cluster */
-                alias?: string;
-                /** Size of each page of results */
-                page_size?: number;
-                /** Cursor to paginate the document retrieval */
-                cursor?: string;
-            };
             header: {
                 /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
                 Authorization: string;
@@ -4187,9 +4515,79 @@ export interface operations {
                 };
             };
         };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ClustercentroidsList"];
+            };
+        };
     };
-    /** Insert your own cluster centroids for it to be used in approximate search settings and cluster aggregations. */
-    insert_cluster_centroids_api_services_cluster_centroids_insert_post: {
+    /** Retrieve the cluster centroids by IDs */
+    cluster_centroids_get_api_services_cluster_centroids_get_get: {
+        parameters: {
+            query: {
+                /** Unique name of dataset */
+                dataset_id: string;
+                /** List of cluster IDs */
+                cluster_ids: string[];
+                /** The vector field where a clustering task was run. */
+                vector_field: string;
+                /** Alias is used to name a cluster */
+                alias?: string;
+                /** Size of each page of results */
+                page_size?: number;
+                /** Cursor to paginate the document retrieval */
+                cursor?: string;
+            };
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    /** Retrieve the cluster centroids by IDs */
+    cluster_centroids_get_api_services_cluster_centroids_get_post: {
+        parameters: {
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CentroidsGetV2"];
+            };
+        };
+    };
+    /** Insert your own cluster centroids for it to be used in approximate search settings and cluster aggregations. */
+    insert_cluster_centroids_2_api_services_cluster_centroids_insert_post: {
         parameters: {
             header: {
                 /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
@@ -4212,7 +4610,125 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CentroidInsertBody"];
+                "application/json": components["schemas"]["CentroidInsertBodyV2"];
+            };
+        };
+    };
+    /** Update a centroid by ID */
+    update_centroids_api_v2_services_cluster_centroids_update_post: {
+        parameters: {
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CentroidUpdateBodyV2"];
+            };
+        };
+    };
+    /** Delete a centroid by ID */
+    delete_centroids_api_services_cluster_centroids__centroid_id__delete_get: {
+        parameters: {
+            path: {
+                centroid_id: string;
+            };
+            query: {
+                dataset_id: string;
+                vector_field: string;
+                alias: string;
+            };
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    /** Delete a centroid by ID */
+    delete_centroids_api_services_cluster_centroids__centroid_id__delete_post: {
+        parameters: {
+            path: {
+                centroid_id: string;
+            };
+            query: {
+                dataset_id: string;
+                vector_field: string;
+                alias: string;
+            };
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    /** Delete centroids by dataset ID, vector field and alias */
+    cluster_centroids_delete_api_services_cluster_centroids_delete_post: {
+        parameters: {
+            query: {
+                dataset_id: string;
+                vector_field: string;
+                alias: string;
+            };
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
             };
         };
     };
@@ -4244,12 +4760,127 @@ export interface operations {
             };
         };
     };
+    /** Retrieves metadata about a dataset. notably description, data source, etc */
+    centroids_metadata_get_api_services_cluster_centroids_metadata_get: {
+        parameters: {
+            query: {
+                /** Unique name of dataset */
+                dataset_id: string;
+                /** It can either be an array of strings (automatically equally weighted) (e.g. ['check_vector_', 'yellow_vector_']). */
+                vector_field: string;
+                /** Alias used to name a vector field. Belongs in field_{alias}_vector_ */
+                alias?: string;
+            };
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    /** You can store the metadata about your cluster here. */
+    centroids_metadata_post_api_v2_services_cluster_centroids_metadata_post: {
+        parameters: {
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CentroidMetadataV2"];
+            };
+        };
+    };
+    /** List of documents closest from the centre. */
+    centroids_list_closest_to_center_v2_services_cluster_centroids_list_closest_to_center_post: {
+        parameters: {
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CentroidsClosestToCenterV2"];
+            };
+        };
+    };
+    /** List of documents from from the centre */
+    centroids_list_furthest_from_center_v2_services_cluster_centroids_list_furthest_from_center_post: {
+        parameters: {
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CentroidsFurthestFromCenterV2"];
+            };
+        };
+    };
     /**
      * Takes an aggregation query and gets the aggregate of each cluster in a collection. This helps you interpret each cluster and what is in them.
      *
      * Only can be used after a vector field has been clustered with /cluster.
      */
-    cluster_aggregate_api_services_cluster_aggregate_post: {
+    cluster_aggregate_api_v2_services_cluster_aggregate_post: {
         parameters: {
             header: {
                 /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
@@ -4272,7 +4903,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["ClusterAggregateQueryCommons"];
+                "application/json": components["schemas"]["ClusterAggregateQueryCommonsV2"];
             };
         };
     };
@@ -4281,11 +4912,13 @@ export interface operations {
      *
      * Only can be used after a vector field has been clustered with /cluster.
      */
-    cluster_facets_api_services_cluster_facets_get: {
+    advanced_cluster_facets_api_services_cluster_facets_get: {
         parameters: {
             query: {
                 /** Unique name of dataset */
                 dataset_id: string;
+                /** It can either be an array of strings (automatically equally weighted) (e.g. ['check_vector_', 'yellow_vector_']). */
+                vector_field: string;
                 /** Fields to include in the facets, if [] then all */
                 facets_fields?: string[];
                 /** Size of facet page */
@@ -4317,6 +4950,68 @@ export interface operations {
             };
         };
     };
+    /** Get a list of cluster IDs based on the relevant information */
+    cluster_list_services_cluster_list_get: {
+        parameters: {
+            query: {
+                /** Unique name of dataset */
+                dataset_id: string;
+                /** It can either be an array of strings (automatically equally weighted) (e.g. ['check_vector_', 'yellow_vector_']). */
+                vector_field: string;
+                /** Alias is used to name a cluster */
+                alias?: string;
+            };
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    /** Get a list of cluster IDs */
+    cluster_list_multi_services_cluster_list_post: {
+        parameters: {
+            query: {
+                /** Unique name of dataset */
+                dataset_id: string;
+                /** The vector field to search in. It can either be an array of strings (automatically equally weighted) (e.g. ['check_vector_', 'yellow_vector_']) or it is a dictionary mapping field to float where the weighting is explicitly specified (e.g. {'check_vector_': 0.2, 'yellow_vector_': 0.5}) */
+                vector_fields: string;
+                /** Alias is used to name a cluster */
+                alias?: string;
+            };
+            header: {
+                /** Authorization credentials. Header authorization should be in the form of **"project:api_key"** */
+                Authorization: string;
+            };
+        };
+        responses: {
+            /** Successful Response */
+            200: {
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** Validation Error */
+            422: {
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     /** Tag documents or vectors. */
     tag_api_services_tagger_tag_post: {
         parameters: {