From ab20442d3f53f5b7cc2b324af222cb99deb31008 Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Wed, 22 May 2024 20:35:15 -0700 Subject: [PATCH 01/17] update descriptions and endpoints --- fern/api-description-overwrites.yml | 260 ++++++++++++---------------- 1 file changed, 107 insertions(+), 153 deletions(-) diff --git a/fern/api-description-overwrites.yml b/fern/api-description-overwrites.yml index 7332aed..dd0ff28 100644 --- a/fern/api-description-overwrites.yml +++ b/fern/api-description-overwrites.yml @@ -2,214 +2,184 @@ paths: /: get: description: Returns details about the running Qdrant instance. - summary: Returns information about the running Qdrant instance + summary: Retrieve instance details tags: - Service /aliases: get: - description: Get list of all existing collections aliases - summary: List collections aliases + description: Retrieves a list of all existing aliases. + summary: List all aliases tags: - Aliases /cluster: get: - description: Get information about the current state and composition of the - cluster - summary: Get cluster status info + description: Returns information about the cluster's current state and composition. + summary: Check cluster status tags: - Distributed /cluster/peer/{peer_id}: delete: - description: Tries to remove peer from the cluster. Will return an error if - peer has shards on it. - summary: Remove peer from the cluster + description: Attempts to remove the node from the cluster. This endpoint returns an error if the node (peer) has shards on it. + summary: Remove peer from cluster tags: - Distributed /cluster/recover: post: - summary: Tries to recover current peer Raft state. + description: Attempts to restore or synchronize the node's current state with that of its peers. + summary: Recover cluster state tags: - Distributed /collections: get: - description: Get list name of all existing collections - summary: List collections + description: Returns a list of all existing collections. + summary: List all collections tags: - Collections /collections/aliases: post: - summary: Update aliases of the collections + description: Updates aliases for the specified collections. + summary: Update collection aliases tags: - Aliases /collections/{collection_name}: delete: - description: Drop collection and all associated data - summary: Delete collection + description: Drops the specified collection and all associated data in it. + summary: Delete a collection tags: - Collections get: - description: Get detailed information about specified existing collection - summary: Collection info + description: Retrieves details about the specified collection. + summary: Get collection parameters tags: - Collections patch: - description: Update parameters of the existing collection + description: Updates the parameters of the specified collection. summary: Update collection parameters tags: - Collections put: - description: Create new collection with given parameters - summary: Create collection + description: Creates a new collection with the given parameters. + summary: Create a collection tags: - Collections /collections/{collection_name}/aliases: get: - description: Get list of all aliases for a collection - summary: List aliases for collection + description: Retrieves a list of all aliases for the specified collection. + summary: List collection aliases tags: - Aliases /collections/{collection_name}/cluster: get: - description: Get cluster information for a collection - summary: Collection cluster info + description: Retrieves cluster details for a specified collection. + summary: Retrieve cluster details tags: - Distributed post: - summary: Update collection cluster setup + description: Updates the cluster configuration for a specified collection. + summary: Update cluster setup tags: - Distributed /collections/{collection_name}/exists: get: - description: Returns "true" if the given collection name exists, and "false" - otherwise - summary: Check the existence of a collection + description: Checks whether the specified collection exists. + summary: Check collection existence tags: - Collections /collections/{collection_name}/index: put: - description: Create index for field in collection - summary: Create index for field in collection + description: Creates a payload index for a field in the specified collection. + summary: Create payload index tags: - Indexes /collections/{collection_name}/index/{field_name}: delete: - description: Delete field index for collection - summary: Delete index for field in collection + description: Deletes a payload index for a field in the specified collection. + summary: Delete payload index tags: - Indexes /collections/{collection_name}/points: post: - description: Retrieve multiple points by specified IDs - summary: Get points + description: Retrieves all details from multiple points. + summary: Retrieve points tags: - Points put: - description: Perform insert + updates on points. If point with given ID already - exists - it will be overwritten. + description: Performs the insert + update action on specified points. Any point with an existing {id} will be overwritten. summary: Upsert points tags: - Points /collections/{collection_name}/points/batch: post: - description: Apply a series of update operations for points, vectors and payloads + description: Batch updates points, including their respective vectors and payloads. summary: Batch update points tags: - Points /collections/{collection_name}/points/count: post: - description: Count points which matches given filtering condition + description: Counts the number of points that match a specified filtering condition. summary: Count points tags: - Points /collections/{collection_name}/points/delete: post: - description: Delete points + description: Deletes specified points from the collection. summary: Delete points tags: - Points /collections/{collection_name}/points/discover: post: - description: 'Retrieves the most similar points to a given target, constrained - by the provided context. + description: 'Retrieves the most similar points to a given target, constrained by the provided context. +Context Search: When only the context is provided (without a target), pairs of points are used to generate a loss that guides the search towards the area where most positive examples overlap. The score minimizes finding points closer to a negative example than to a positive example. The maximum score a point can achieve is 0.0, meaning many points may have a score of 0.0. - Context Search: When only the context is provided (without a target), - - pairs of points are used to generate a loss that guides the search towards - the area where most positive examples overlap. - - The score minimizes finding points closer to a negative example than to a - positive example. - - The maximum score a point can achieve is 0.0, meaning many points may have - a score of 0.0. - - - Target Search: When a target is provided (with or without context), the score - consists of two parts: - - the integer part represents the rank with respect to the context, and the - decimal part relates to the distance to the target. - - The context score for each pair is +1 if the point is closer to a positive - example than to a negative example, and -1 otherwise." - - ' +Target Search: When a target is provided (with or without context), the score consists of two parts: the integer part represents the rank with respect to the context, and the decimal part relates to the distance to the target. The context score for each pair is +1 if the point is closer to a positive example than to a negative example, and -1 otherwise.' summary: Discover points tags: - Search /collections/{collection_name}/points/discover/batch: post: - description: Retrieves points in batches based on the target and/or positive - and negative example pairs. + description: Retrieves points in batches based on the target and/or positive and negative example pairs. summary: Discover batch points tags: - Search /collections/{collection_name}/points/payload: post: - description: Set payload values for points + description: Sets payload values for specified points. summary: Set payload tags: - Points put: - description: Replace full payload of points with new one + description: Replaces the entire payload of a specified point with a new payload. summary: Overwrite payload tags: - Points /collections/{collection_name}/points/payload/clear: post: - description: Remove all payload for specified points + description: Removes the entire payload for specified points. summary: Clear payload tags: - Points /collections/{collection_name}/points/payload/delete: post: - description: Delete specified key payload for points + description: Deletes a specified key payload for points. summary: Delete payload tags: - Points /collections/{collection_name}/points/recommend: post: - description: Retrieves points that are closer to stored positive examples and - further from negative examples. + description: Retrieves points that are closer to stored positive examples and further from negative examples. summary: Recommend points tags: - Points /collections/{collection_name}/points/recommend/batch: post: - description: Retrieves points in batches that are closer to stored positive - examples and further from negative examples. + description: Retrieves points in batches that are closer to stored positive examples and further from negative examples. summary: Recommend batch points tags: - Search /collections/{collection_name}/points/recommend/groups: post: - description: 'Retrieves points that are closer to stored positive examples and - further from negative examples. - - Results are grouped by the specified payload field. - - ' + description: Retrieves points that are closer to stored positive examples and further from negative examples. Results are grouped by the specified payload field. summary: Recommend point groups tags: - Search @@ -229,207 +199,191 @@ paths: - Search /collections/{collection_name}/points/search: post: - description: Retrieves the closest points based on vector similarity and given - filtering conditions. + description: Retrieves the closest points based on vector similarity and given filtering conditions. summary: Search points tags: - Search /collections/{collection_name}/points/search/batch: post: - description: Retrieves the closest points in batches based on vector similarity - and given filtering conditions + description: Retrieves the closest points in batches based on vector similarity and given filtering conditions. summary: Search batch points tags: - Search /collections/{collection_name}/points/search/groups: post: - description: Retrieves the closest points based on vector similarity and given - filtering conditions, grouped by a given payload field. + description: Retrieves the closest points based on vector similarity and given filtering conditions, grouped by a given payload field. summary: Search point groups tags: - Search /collections/{collection_name}/points/vectors: put: - description: Update specified named vectors on points, keep unspecified vectors - intact. + description: Updates specified vectors on points. All other unspecified vectors will stay intact. summary: Update vectors tags: - Points /collections/{collection_name}/points/vectors/delete: post: - description: Delete named vectors from the given points. + description: Deletes specified vectors from points. All other unspecified vectors will stay intact. summary: Delete vectors tags: - Points /collections/{collection_name}/points/{id}: get: - description: Retrieve full information of single point by id - summary: Get point + description: Retrieves all details from a single point. + summary: Retrieve a point tags: - Points /collections/{collection_name}/shards: put: - summary: Create shard key + description: Creates one or more shard keys for a specified collection. + summary: Create a shard key tags: - Distributed /collections/{collection_name}/shards/delete: post: - summary: Delete shard key + description: Deletes one or more shard keys for a specified collection. + summary: Delete a shard key tags: - Distributed /collections/{collection_name}/shards/{shard_id}/snapshots: get: - description: Get list of snapshots for a shard of a collection - summary: List shards snapshots for a collection + description: Returns a list of all snapshots for a shard from a collection. + summary: List all snapshots (shard) tags: - Snapshots post: - description: Create new snapshot of a shard for a collection - summary: Create shard snapshot + description: Creates a new snapshot of a shard from a collection. + summary: Create a snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/recover: put: - description: Recover shard of a local collection data from a snapshot. This - will overwrite any data, stored in this shard, for the collection. - summary: Recover from a snapshot + description: Recovers the shard of a local collection from a snapshot. This will overwrite any collection data, which is stored in this shard. + summary: Recover from snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/upload: post: - description: Recover shard of a local collection from an uploaded snapshot. - This will overwrite any data, stored on this node, for the collection shard. - summary: Recover shard from an uploaded snapshot + description: Recovers the shard of a local collection from an uploaded snapshot. This will overwrite any collection data, which is stored in this shard. + summary: Recover from uploaded snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/{snapshot_name}: delete: - description: Delete snapshot of a shard for a collection - summary: Delete shard snapshot + description: Deletes the specified snapshot of a shard from a collection. + summary: Delete a snapshot (shard) tags: - Snapshots get: - description: Download specified snapshot of a shard from a collection as a file - summary: Download collection snapshot + description: Downloads the specified snapshot of a shard from a collection as a file. + summary: Download a snapshot (shard) tags: - Snapshots /collections/{collection_name}/snapshots: get: - description: Get list of snapshots for a collection - summary: List collection snapshots + description: Retrieves a list of all snapshots for a specified collection. + summary: List all snapshots (collection) tags: - Snapshots post: - description: Create new snapshot for a collection - summary: Create collection snapshot + description: Creates a new snapshot for a specified collection. + summary: Create a snapshot (collection) tags: - Snapshots /collections/{collection_name}/snapshots/recover: put: - description: Recover local collection data from a snapshot. This will overwrite - any data, stored on this node, for the collection. If collection does not - exist - it will be created. - summary: Recover from a snapshot + description: Recovers local collection data from a snapshot. This will overwrite any collection data stored on the node. If the collection does not exist, it will be created. + summary: Recover from a snapshot (collection) tags: - Snapshots /collections/{collection_name}/snapshots/upload: post: - description: Recover local collection data from an uploaded snapshot. This will - overwrite any data, stored on this node, for the collection. If collection - does not exist - it will be created. - summary: Recover from an uploaded snapshot + description: Recovers local collection data from an uploaded snapshot. This will overwrite any collection data stored on the node. If the collection does not exist, it will be created. + summary: Recover from an uploaded snapshot (collection) tags: - Snapshots /collections/{collection_name}/snapshots/{snapshot_name}: delete: - description: Delete snapshot for a collection - summary: Delete collection snapshot + description: Deletes the specified snapshot for a collection. + summary: Delete a snapshot (collection) tags: - Snapshots get: - description: Download specified snapshot from a collection as a file - summary: Download collection snapshot + description: Downloads the specified snapshot file from a collection. + summary: Download a snapshot (collection) tags: - Snapshots /healthz: get: - description: Checks the health of individual service instance. - summary: Kubernetes healthz endpoint + description: Monitors the health of individual containers. + summary: Kubernetes health check tags: - Service /issues: delete: - description: Removes all issues reported so far + description: Removes all issues reported so far. summary: Clear issues tags: - Beta get: - description: Get a report of performance issues and configuration suggestions - summary: Get issues + description: Retrieves a report of performance issues and configuration suggestions. + summary: Report issues tags: - Beta /livez: get: - description: Checks the health of individual service instance. - summary: Kubernetes livez endpoint + description: Monitors the container responsiveness and alerts in case of failure. + summary: Kubernetes liveness probe tags: - Service /locks: get: - description: Retrieves the current lock setting. If write is false, all write - operations and collection creation are restricted. - summary: Get lock options + description: Retrieves the current lock setting. If write is false, all write operations and collection creation are restricted. + summary: Check write protection tags: - Service post: - description: Restricts all write operations and forbids collection creation. - This endpoint also returns previous lock options. - summary: Set lock options + description: Restricts all write operations and forbids collection creation. This endpoint also returns previous lock options. + summary: Set write protection tags: - Service /metrics: get: - description: 'Collect metrics data, such as: application info, collection info, - cluster info and statistics. - - ' + description: 'Collect metrics data, such as: application info, collection info, cluster info and statistics.' summary: Collect Prometheus metrics data tags: - Service /readyz: get: - description: Checks the service to see when it can start accepting traffic. - summary: Kubernetes readyz endpoint + description: Monitors the container to see when it can start accepting traffic. + summary: Kubernetes readiness probe tags: - Service /snapshots: get: - description: Get list of snapshots of the whole storage - summary: List of storage snapshots + description: Returns a list of all snapshots for the entire storage. + summary: List all snapshots (storage) tags: - Snapshots post: - description: Create new snapshot of the whole storage - summary: Create storage snapshot + description: Creates a new snapshot of the entire storage. + summary: Create a snapshot (storage) tags: - Snapshots /snapshots/{snapshot_name}: delete: - description: Delete snapshot of the whole storage - summary: Delete storage snapshot + description: Deletes the specified snapshot of the entire storage. + summary: Delete a snapshot (storage) tags: - Snapshots get: - description: Download specified snapshot of the whole storage as a file - summary: Download storage snapshot + description: Downloads the specified snapshot of the entire storage as a file. + summary: Download a snapshot (storage) tags: - Snapshots /telemetry: get: - description: 'Collects telemetry data, such as: application info, system info, - collection info, cluster info, configs and statistics." - - ' + description: 'Collects telemetry data, such as: application info, system info, collection info, cluster info, configs and statistics.' summary: Collect telemetry data tags: - Service From 6a18b06be5b5c6af4e29451788d77cfc87719393 Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Thu, 23 May 2024 03:37:02 +0000 Subject: [PATCH 02/17] Sync OpenAPI --- fern/apis/master/openapi-overrides.yml | 215 ++++++++++++------------- fern/apis/v1.9.x/openapi-overrides.yml | 215 ++++++++++++------------- 2 files changed, 198 insertions(+), 232 deletions(-) diff --git a/fern/apis/master/openapi-overrides.yml b/fern/apis/master/openapi-overrides.yml index c618724..19710f3 100644 --- a/fern/apis/master/openapi-overrides.yml +++ b/fern/apis/master/openapi-overrides.yml @@ -57,8 +57,8 @@ paths: ' language: python - description: Get list of all existing collections aliases - summary: List collections aliases + description: Retrieves a list of all existing aliases. + summary: List all aliases tags: - Aliases /collections: @@ -111,8 +111,8 @@ paths: ' language: python - description: Get list name of all existing collections - summary: List collections + description: Returns a list of all existing collections. + summary: List all collections tags: - Collections /collections/aliases: @@ -155,7 +155,8 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.update_collection_aliases(\n change_aliases_operations=[\n models.CreateAliasOperation(\n create_alias=models.CreateAlias(\n collection_name=\"example_collection\", alias_name=\"production_collection\"\n )\n )\n ]\n)\n\nclient.update_collection_aliases(\n change_aliases_operations=[\n models.DeleteAliasOperation(\n delete_alias=models.DeleteAlias(alias_name=\"production_collection\")\n ),\n ]\n)\n" language: python - summary: Update aliases of the collections + description: Updates aliases for the specified collections. + summary: Update collection aliases tags: - Aliases /collections/{collection_name}: @@ -208,8 +209,8 @@ paths: ' language: python - description: Drop collection and all associated data - summary: Delete collection + description: Drops the specified collection and all associated data in it. + summary: Delete a collection tags: - Collections get: @@ -261,8 +262,8 @@ paths: ' language: python - description: Get detailed information about specified existing collection - summary: Collection info + description: Retrieves details about the specified collection. + summary: Get collection parameters tags: - Collections patch: @@ -282,7 +283,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.update_collection(\n collection_name=\"{collection_name}\",\n optimizer_config=models.OptimizersConfigDiff(indexing_threshold=10000),\n)\n" language: python - description: Update parameters of the existing collection + description: Updates the parameters of the specified collection. summary: Update collection parameters tags: - Collections @@ -306,8 +307,8 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.create_collection(\n collection_name=\"{collection_name}\",\n vectors_config=models.VectorParams(size=100, distance=models.Distance.COSINE),\n)\n" language: python - description: Create new collection with given parameters - summary: Create collection + description: Creates a new collection with the given parameters. + summary: Create a collection tags: - Collections /collections/{collection_name}/aliases: @@ -360,8 +361,8 @@ paths: ' language: python - description: Get list of all aliases for a collection - summary: List aliases for collection + description: Retrieves a list of all aliases for the specified collection. + summary: List collection aliases tags: - Aliases /collections/{collection_name}/index: @@ -382,8 +383,8 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.create_payload_index(\n collection_name=\"{collection_name}\",\n field_name=\"name_of_the_field_to_index\",\n field_schema=\"keyword\",\n)\n" language: python - description: Create index for field in collection - summary: Create index for field in collection + description: Creates a payload index for a field in the specified collection. + summary: Create payload index tags: - Indexes /collections/{collection_name}/index/{field_name}: @@ -420,8 +421,8 @@ paths: ' language: python - description: Delete field index for collection - summary: Delete index for field in collection + description: Deletes a payload index for a field in the specified collection. + summary: Delete payload index tags: - Indexes /collections/{collection_name}/points: @@ -442,8 +443,8 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.retrieve(\n collection_name=\"{collection_name}\",\n ids=[0, 3, 100],\n)\n" language: python - description: Retrieve multiple points by specified IDs - summary: Get points + description: Retrieves all details from multiple points. + summary: Retrieve points tags: - Points put: @@ -463,7 +464,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.upsert(\n collection_name=\"{collection_name}\",\n points=[\n models.PointStruct(\n id=1,\n payload={\n \"color\": \"red\",\n },\n vector=[0.9, 0.1, 0.1],\n ),\n models.PointStruct(\n id=2,\n payload={\n \"color\": \"green\",\n },\n vector=[0.1, 0.9, 0.1],\n ),\n models.PointStruct(\n id=3,\n payload={\n \"color\": \"blue\",\n },\n vector=[0.1, 0.1, 0.9],\n ),\n ],\n)\n" language: python - description: Perform insert + updates on points. If point with given ID already exists - it will be overwritten. + description: Performs the insert + update action on specified points. Any point with an existing {id} will be overwritten. summary: Upsert points tags: - Points @@ -485,7 +486,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.batch_update_points(\n collection_name=\"{collection_name}\",\n update_operations=[\n models.UpsertOperation(\n upsert=models.PointsList(\n points=[\n models.PointStruct(\n id=1,\n vector=[1.0, 2.0, 3.0, 4.0],\n payload={},\n ),\n ]\n )\n ),\n models.UpdateVectorsOperation(\n update_vectors=models.UpdateVectors(\n points=[\n models.PointVectors(\n id=1,\n vector=[1.0, 2.0, 3.0, 4.0],\n )\n ]\n )\n ),\n models.SetPayloadOperation(\n set_payload=models.SetPayload(\n payload={\n \"test_payload_2\": 2,\n \"test_payload_3\": 3,\n },\n points=[1],\n )\n ),\n ],\n)\n" language: python - description: Apply a series of update operations for points, vectors and payloads + description: Batch updates points, including their respective vectors and payloads. summary: Batch update points tags: - Points @@ -507,7 +508,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.count(\n collection_name=\"{collection_name}\",\n count_filter=models.Filter(\n must=[\n models.FieldCondition(key=\"color\", match=models.MatchValue(value=\"red\")),\n ]\n ),\n exact=True,\n)\n" language: python - description: Count points which matches given filtering condition + description: Counts the number of points that match a specified filtering condition. summary: Count points tags: - Points @@ -540,7 +541,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.delete(\n collection_name=\"{collection_name}\",\n points_selector=models.PointIdsList(\n points=[0, 3, 100],\n ),\n)\n\nclient.delete(\n collection_name=\"{collection_name}\",\n points_selector=models.FilterSelector(\n filter=models.Filter(\n must=[\n models.FieldCondition(\n key=\"color\",\n match=models.MatchValue(value=\"red\"),\n ),\n ],\n )\n ),\n)\n" language: python - description: Delete points + description: Deletes specified points from the collection. summary: Delete points tags: - Points @@ -564,23 +565,9 @@ paths: language: python description: 'Retrieves the most similar points to a given target, constrained by the provided context. + Context Search: When only the context is provided (without a target), pairs of points are used to generate a loss that guides the search towards the area where most positive examples overlap. The score minimizes finding points closer to a negative example than to a positive example. The maximum score a point can achieve is 0.0, meaning many points may have a score of 0.0. - Context Search: When only the context is provided (without a target), - - pairs of points are used to generate a loss that guides the search towards the area where most positive examples overlap. - - The score minimizes finding points closer to a negative example than to a positive example. - - The maximum score a point can achieve is 0.0, meaning many points may have a score of 0.0. - - - Target Search: When a target is provided (with or without context), the score consists of two parts: - - the integer part represents the rank with respect to the context, and the decimal part relates to the distance to the target. - - The context score for each pair is +1 if the point is closer to a positive example than to a negative example, and -1 otherwise." - -' + Target Search: When a target is provided (with or without context), the score consists of two parts: the integer part represents the rank with respect to the context, and the decimal part relates to the distance to the target. The context score for each pair is +1 if the point is closer to a positive example than to a negative example, and -1 otherwise.' summary: Discover points tags: - Search @@ -624,7 +611,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.set_payload(\n collection_name=\"{collection_name}\",\n payload={\n \"property1\": \"string\",\n \"property2\": \"string\",\n },\n points=[0, 3, 10],\n)\n" language: python - description: Set payload values for points + description: Sets payload values for specified points. summary: Set payload tags: - Points @@ -645,7 +632,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.overwrite_payload(\n collection_name=\"{collection_name}\",\n payload={\n \"property1\": \"string\",\n \"property2\": \"string\",\n },\n points=[0, 3, 10],\n)\n" language: python - description: Replace full payload of points with new one + description: Replaces the entire payload of a specified point with a new payload. summary: Overwrite payload tags: - Points @@ -675,7 +662,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.clear_payload(\n collection_name=\"{collection_name}\",\n points_selector=[0, 3, 100],\n)\n" language: python - description: Remove all payload for specified points + description: Removes the entire payload for specified points. summary: Clear payload tags: - Points @@ -705,7 +692,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.delete_payload(\n collection_name=\"{collection_name}\",\n keys=[\"color\", \"price\"],\n points=[0, 3, 100],\n)\n" language: python - description: Delete specified key payload for points + description: Deletes a specified key payload for points. summary: Delete payload tags: - Points @@ -771,11 +758,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.recommend_groups(\n collection_name=\"{collection_name}\",\n positive=[100, 231],\n negative=[718],\n group_by=\"document_id\",\n limit=3,\n group_size=2,\n)\n" language: python - description: 'Retrieves points that are closer to stored positive examples and further from negative examples. - - Results are grouped by the specified payload field. - -' + description: Retrieves points that are closer to stored positive examples and further from negative examples. Results are grouped by the specified payload field. summary: Recommend point groups tags: - Search @@ -849,7 +832,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nfilter_ = models.Filter(\n must=[\n models.FieldCondition(\n key=\"city\",\n match=models.MatchValue(\n value=\"London\",\n ),\n )\n ]\n)\n\nsearch_queries = [\n models.SearchRequest(vector=[0.2, 0.1, 0.9, 0.7], filter=filter_, limit=3),\n models.SearchRequest(vector=[0.5, 0.3, 0.2, 0.3], filter=filter_, limit=3),\n]\n\nclient.search_batch(collection_name=\"{collection_name}\", requests=search_queries)\n" language: python - description: Retrieves the closest points in batches based on vector similarity and given filtering conditions + description: Retrieves the closest points in batches based on vector similarity and given filtering conditions. summary: Search batch points tags: - Search @@ -893,7 +876,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.update_vectors(\n collection_name=\"{collection_name}\",\n points=[\n models.PointVectors(\n id=1,\n vector={\n \"image\": [0.1, 0.2, 0.3, 0.4],\n },\n ),\n models.PointVectors(\n id=2,\n vector={\n \"text\": [0.9, 0.8, 0.7, 0.6, 0.5, 0.4, 0.3, 0.2],\n },\n ),\n ],\n)\n" language: python - description: Update specified named vectors on points, keep unspecified vectors intact. + description: Updates specified vectors on points. All other unspecified vectors will stay intact. summary: Update vectors tags: - Points @@ -923,7 +906,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.delete_vectors(\n collection_name=\"{collection_name}\",\n points=[0, 3, 100],\n vectors=[\"text\", \"image\"],\n)\n" language: python - description: Delete named vectors from the given points. + description: Deletes specified vectors from points. All other unspecified vectors will stay intact. summary: Delete vectors tags: - Points @@ -953,7 +936,8 @@ paths: ' language: python - summary: Create shard key + description: Creates one or more shard keys for a specified collection. + summary: Create a shard key tags: - Distributed /collections/{collection_name}/shards/delete: @@ -982,7 +966,8 @@ paths: ' language: python - summary: Delete shard key + description: Deletes one or more shard keys for a specified collection. + summary: Delete a shard key tags: - Distributed /collections/{collection_name}/snapshots: @@ -1035,8 +1020,8 @@ paths: ' language: python - description: Get list of snapshots for a collection - summary: List collection snapshots + description: Retrieves a list of all snapshots for a specified collection. + summary: List all snapshots (collection) tags: - Snapshots post: @@ -1088,8 +1073,8 @@ paths: ' language: python - description: Create new snapshot for a collection - summary: Create collection snapshot + description: Creates a new snapshot for a specified collection. + summary: Create a snapshot (collection) tags: - Snapshots /collections/{collection_name}/snapshots/recover: @@ -1101,8 +1086,8 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.recover_snapshot(\n \"{collection_name}\",\n \"http://example.com/path/to/snapshot.shapshot\",\n)\n" language: python - description: Recover local collection data from a snapshot. This will overwrite any data, stored on this node, for the collection. If collection does not exist - it will be created. - summary: Recover from a snapshot + description: Recovers local collection data from a snapshot. This will overwrite any collection data stored on the node. If the collection does not exist, it will be created. + summary: Recover from a snapshot (collection) tags: - Snapshots /collections/{collection_name}/snapshots/{snapshot_name}: @@ -1139,13 +1124,13 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.delete_snapshot(\n collection_name=\"{collection_name}\", snapshot_name=\"{snapshot_name}\"\n)\n" language: python - description: Delete snapshot for a collection - summary: Delete collection snapshot + description: Deletes the specified snapshot for a collection. + summary: Delete a snapshot (collection) tags: - Snapshots get: - description: Download specified snapshot from a collection as a file - summary: Download collection snapshot + description: Downloads the specified snapshot file from a collection. + summary: Download a snapshot (collection) tags: - Snapshots /snapshots: @@ -1198,8 +1183,8 @@ paths: ' language: python - description: Get list of snapshots of the whole storage - summary: List of storage snapshots + description: Returns a list of all snapshots for the entire storage. + summary: List all snapshots (storage) tags: - Snapshots post: @@ -1251,8 +1236,8 @@ paths: ' language: python - description: Create new snapshot of the whole storage - summary: Create storage snapshot + description: Creates a new snapshot of the entire storage. + summary: Create a snapshot (storage) tags: - Snapshots /snapshots/{snapshot_name}: @@ -1305,153 +1290,151 @@ paths: ' language: python - description: Delete snapshot of the whole storage - summary: Delete storage snapshot + description: Deletes the specified snapshot of the entire storage. + summary: Delete a snapshot (storage) tags: - Snapshots get: - description: Download specified snapshot of the whole storage as a file - summary: Download storage snapshot + description: Downloads the specified snapshot of the entire storage as a file. + summary: Download a snapshot (storage) tags: - Snapshots /: get: description: Returns details about the running Qdrant instance. - summary: Returns information about the running Qdrant instance + summary: Retrieve instance details tags: - Service /cluster: get: - description: Get information about the current state and composition of the cluster - summary: Get cluster status info + description: Returns information about the cluster's current state and composition. + summary: Check cluster status tags: - Distributed /cluster/peer/{peer_id}: delete: - description: Tries to remove peer from the cluster. Will return an error if peer has shards on it. - summary: Remove peer from the cluster + description: Attempts to remove the node from the cluster. This endpoint returns an error if the node (peer) has shards on it. + summary: Remove peer from cluster tags: - Distributed /cluster/recover: post: - summary: Tries to recover current peer Raft state. + description: Attempts to restore or synchronize the node's current state with that of its peers. + summary: Recover cluster state tags: - Distributed /collections/{collection_name}/cluster: get: - description: Get cluster information for a collection - summary: Collection cluster info + description: Retrieves cluster details for a specified collection. + summary: Retrieve cluster details tags: - Distributed post: - summary: Update collection cluster setup + description: Updates the cluster configuration for a specified collection. + summary: Update cluster setup tags: - Distributed /collections/{collection_name}/exists: get: - description: Returns "true" if the given collection name exists, and "false" otherwise - summary: Check the existence of a collection + description: Checks whether the specified collection exists. + summary: Check collection existence tags: - Collections /collections/{collection_name}/points/{id}: get: - description: Retrieve full information of single point by id - summary: Get point + description: Retrieves all details from a single point. + summary: Retrieve a point tags: - Points /collections/{collection_name}/shards/{shard_id}/snapshots: get: - description: Get list of snapshots for a shard of a collection - summary: List shards snapshots for a collection + description: Returns a list of all snapshots for a shard from a collection. + summary: List all snapshots (shard) tags: - Snapshots post: - description: Create new snapshot of a shard for a collection - summary: Create shard snapshot + description: Creates a new snapshot of a shard from a collection. + summary: Create a snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/recover: put: - description: Recover shard of a local collection data from a snapshot. This will overwrite any data, stored in this shard, for the collection. - summary: Recover from a snapshot + description: Recovers the shard of a local collection from a snapshot. This will overwrite any collection data, which is stored in this shard. + summary: Recover from snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/upload: post: - description: Recover shard of a local collection from an uploaded snapshot. This will overwrite any data, stored on this node, for the collection shard. - summary: Recover shard from an uploaded snapshot + description: Recovers the shard of a local collection from an uploaded snapshot. This will overwrite any collection data, which is stored in this shard. + summary: Recover from uploaded snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/{snapshot_name}: delete: - description: Delete snapshot of a shard for a collection - summary: Delete shard snapshot + description: Deletes the specified snapshot of a shard from a collection. + summary: Delete a snapshot (shard) tags: - Snapshots get: - description: Download specified snapshot of a shard from a collection as a file - summary: Download collection snapshot + description: Downloads the specified snapshot of a shard from a collection as a file. + summary: Download a snapshot (shard) tags: - Snapshots /collections/{collection_name}/snapshots/upload: post: - description: Recover local collection data from an uploaded snapshot. This will overwrite any data, stored on this node, for the collection. If collection does not exist - it will be created. - summary: Recover from an uploaded snapshot + description: Recovers local collection data from an uploaded snapshot. This will overwrite any collection data stored on the node. If the collection does not exist, it will be created. + summary: Recover from an uploaded snapshot (collection) tags: - Snapshots /healthz: get: - description: Checks the health of individual service instance. - summary: Kubernetes healthz endpoint + description: Monitors the health of individual containers. + summary: Kubernetes health check tags: - Service /issues: delete: - description: Removes all issues reported so far + description: Removes all issues reported so far. summary: Clear issues tags: - Beta get: - description: Get a report of performance issues and configuration suggestions - summary: Get issues + description: Retrieves a report of performance issues and configuration suggestions. + summary: Report issues tags: - Beta /livez: get: - description: Checks the health of individual service instance. - summary: Kubernetes livez endpoint + description: Monitors the container responsiveness and alerts in case of failure. + summary: Kubernetes liveness probe tags: - Service /locks: get: description: Retrieves the current lock setting. If write is false, all write operations and collection creation are restricted. - summary: Get lock options + summary: Check write protection tags: - Service post: description: Restricts all write operations and forbids collection creation. This endpoint also returns previous lock options. - summary: Set lock options + summary: Set write protection tags: - Service /metrics: get: - description: 'Collect metrics data, such as: application info, collection info, cluster info and statistics. - -' + description: 'Collect metrics data, such as: application info, collection info, cluster info and statistics.' summary: Collect Prometheus metrics data tags: - Service /readyz: get: - description: Checks the service to see when it can start accepting traffic. - summary: Kubernetes readyz endpoint + description: Monitors the container to see when it can start accepting traffic. + summary: Kubernetes readiness probe tags: - Service /telemetry: get: - description: 'Collects telemetry data, such as: application info, system info, collection info, cluster info, configs and statistics." - -' + description: 'Collects telemetry data, such as: application info, system info, collection info, cluster info, configs and statistics.' summary: Collect telemetry data tags: - Service diff --git a/fern/apis/v1.9.x/openapi-overrides.yml b/fern/apis/v1.9.x/openapi-overrides.yml index c618724..19710f3 100644 --- a/fern/apis/v1.9.x/openapi-overrides.yml +++ b/fern/apis/v1.9.x/openapi-overrides.yml @@ -57,8 +57,8 @@ paths: ' language: python - description: Get list of all existing collections aliases - summary: List collections aliases + description: Retrieves a list of all existing aliases. + summary: List all aliases tags: - Aliases /collections: @@ -111,8 +111,8 @@ paths: ' language: python - description: Get list name of all existing collections - summary: List collections + description: Returns a list of all existing collections. + summary: List all collections tags: - Collections /collections/aliases: @@ -155,7 +155,8 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.update_collection_aliases(\n change_aliases_operations=[\n models.CreateAliasOperation(\n create_alias=models.CreateAlias(\n collection_name=\"example_collection\", alias_name=\"production_collection\"\n )\n )\n ]\n)\n\nclient.update_collection_aliases(\n change_aliases_operations=[\n models.DeleteAliasOperation(\n delete_alias=models.DeleteAlias(alias_name=\"production_collection\")\n ),\n ]\n)\n" language: python - summary: Update aliases of the collections + description: Updates aliases for the specified collections. + summary: Update collection aliases tags: - Aliases /collections/{collection_name}: @@ -208,8 +209,8 @@ paths: ' language: python - description: Drop collection and all associated data - summary: Delete collection + description: Drops the specified collection and all associated data in it. + summary: Delete a collection tags: - Collections get: @@ -261,8 +262,8 @@ paths: ' language: python - description: Get detailed information about specified existing collection - summary: Collection info + description: Retrieves details about the specified collection. + summary: Get collection parameters tags: - Collections patch: @@ -282,7 +283,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.update_collection(\n collection_name=\"{collection_name}\",\n optimizer_config=models.OptimizersConfigDiff(indexing_threshold=10000),\n)\n" language: python - description: Update parameters of the existing collection + description: Updates the parameters of the specified collection. summary: Update collection parameters tags: - Collections @@ -306,8 +307,8 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.create_collection(\n collection_name=\"{collection_name}\",\n vectors_config=models.VectorParams(size=100, distance=models.Distance.COSINE),\n)\n" language: python - description: Create new collection with given parameters - summary: Create collection + description: Creates a new collection with the given parameters. + summary: Create a collection tags: - Collections /collections/{collection_name}/aliases: @@ -360,8 +361,8 @@ paths: ' language: python - description: Get list of all aliases for a collection - summary: List aliases for collection + description: Retrieves a list of all aliases for the specified collection. + summary: List collection aliases tags: - Aliases /collections/{collection_name}/index: @@ -382,8 +383,8 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.create_payload_index(\n collection_name=\"{collection_name}\",\n field_name=\"name_of_the_field_to_index\",\n field_schema=\"keyword\",\n)\n" language: python - description: Create index for field in collection - summary: Create index for field in collection + description: Creates a payload index for a field in the specified collection. + summary: Create payload index tags: - Indexes /collections/{collection_name}/index/{field_name}: @@ -420,8 +421,8 @@ paths: ' language: python - description: Delete field index for collection - summary: Delete index for field in collection + description: Deletes a payload index for a field in the specified collection. + summary: Delete payload index tags: - Indexes /collections/{collection_name}/points: @@ -442,8 +443,8 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.retrieve(\n collection_name=\"{collection_name}\",\n ids=[0, 3, 100],\n)\n" language: python - description: Retrieve multiple points by specified IDs - summary: Get points + description: Retrieves all details from multiple points. + summary: Retrieve points tags: - Points put: @@ -463,7 +464,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.upsert(\n collection_name=\"{collection_name}\",\n points=[\n models.PointStruct(\n id=1,\n payload={\n \"color\": \"red\",\n },\n vector=[0.9, 0.1, 0.1],\n ),\n models.PointStruct(\n id=2,\n payload={\n \"color\": \"green\",\n },\n vector=[0.1, 0.9, 0.1],\n ),\n models.PointStruct(\n id=3,\n payload={\n \"color\": \"blue\",\n },\n vector=[0.1, 0.1, 0.9],\n ),\n ],\n)\n" language: python - description: Perform insert + updates on points. If point with given ID already exists - it will be overwritten. + description: Performs the insert + update action on specified points. Any point with an existing {id} will be overwritten. summary: Upsert points tags: - Points @@ -485,7 +486,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.batch_update_points(\n collection_name=\"{collection_name}\",\n update_operations=[\n models.UpsertOperation(\n upsert=models.PointsList(\n points=[\n models.PointStruct(\n id=1,\n vector=[1.0, 2.0, 3.0, 4.0],\n payload={},\n ),\n ]\n )\n ),\n models.UpdateVectorsOperation(\n update_vectors=models.UpdateVectors(\n points=[\n models.PointVectors(\n id=1,\n vector=[1.0, 2.0, 3.0, 4.0],\n )\n ]\n )\n ),\n models.SetPayloadOperation(\n set_payload=models.SetPayload(\n payload={\n \"test_payload_2\": 2,\n \"test_payload_3\": 3,\n },\n points=[1],\n )\n ),\n ],\n)\n" language: python - description: Apply a series of update operations for points, vectors and payloads + description: Batch updates points, including their respective vectors and payloads. summary: Batch update points tags: - Points @@ -507,7 +508,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.count(\n collection_name=\"{collection_name}\",\n count_filter=models.Filter(\n must=[\n models.FieldCondition(key=\"color\", match=models.MatchValue(value=\"red\")),\n ]\n ),\n exact=True,\n)\n" language: python - description: Count points which matches given filtering condition + description: Counts the number of points that match a specified filtering condition. summary: Count points tags: - Points @@ -540,7 +541,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.delete(\n collection_name=\"{collection_name}\",\n points_selector=models.PointIdsList(\n points=[0, 3, 100],\n ),\n)\n\nclient.delete(\n collection_name=\"{collection_name}\",\n points_selector=models.FilterSelector(\n filter=models.Filter(\n must=[\n models.FieldCondition(\n key=\"color\",\n match=models.MatchValue(value=\"red\"),\n ),\n ],\n )\n ),\n)\n" language: python - description: Delete points + description: Deletes specified points from the collection. summary: Delete points tags: - Points @@ -564,23 +565,9 @@ paths: language: python description: 'Retrieves the most similar points to a given target, constrained by the provided context. + Context Search: When only the context is provided (without a target), pairs of points are used to generate a loss that guides the search towards the area where most positive examples overlap. The score minimizes finding points closer to a negative example than to a positive example. The maximum score a point can achieve is 0.0, meaning many points may have a score of 0.0. - Context Search: When only the context is provided (without a target), - - pairs of points are used to generate a loss that guides the search towards the area where most positive examples overlap. - - The score minimizes finding points closer to a negative example than to a positive example. - - The maximum score a point can achieve is 0.0, meaning many points may have a score of 0.0. - - - Target Search: When a target is provided (with or without context), the score consists of two parts: - - the integer part represents the rank with respect to the context, and the decimal part relates to the distance to the target. - - The context score for each pair is +1 if the point is closer to a positive example than to a negative example, and -1 otherwise." - -' + Target Search: When a target is provided (with or without context), the score consists of two parts: the integer part represents the rank with respect to the context, and the decimal part relates to the distance to the target. The context score for each pair is +1 if the point is closer to a positive example than to a negative example, and -1 otherwise.' summary: Discover points tags: - Search @@ -624,7 +611,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.set_payload(\n collection_name=\"{collection_name}\",\n payload={\n \"property1\": \"string\",\n \"property2\": \"string\",\n },\n points=[0, 3, 10],\n)\n" language: python - description: Set payload values for points + description: Sets payload values for specified points. summary: Set payload tags: - Points @@ -645,7 +632,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.overwrite_payload(\n collection_name=\"{collection_name}\",\n payload={\n \"property1\": \"string\",\n \"property2\": \"string\",\n },\n points=[0, 3, 10],\n)\n" language: python - description: Replace full payload of points with new one + description: Replaces the entire payload of a specified point with a new payload. summary: Overwrite payload tags: - Points @@ -675,7 +662,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.clear_payload(\n collection_name=\"{collection_name}\",\n points_selector=[0, 3, 100],\n)\n" language: python - description: Remove all payload for specified points + description: Removes the entire payload for specified points. summary: Clear payload tags: - Points @@ -705,7 +692,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.delete_payload(\n collection_name=\"{collection_name}\",\n keys=[\"color\", \"price\"],\n points=[0, 3, 100],\n)\n" language: python - description: Delete specified key payload for points + description: Deletes a specified key payload for points. summary: Delete payload tags: - Points @@ -771,11 +758,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.recommend_groups(\n collection_name=\"{collection_name}\",\n positive=[100, 231],\n negative=[718],\n group_by=\"document_id\",\n limit=3,\n group_size=2,\n)\n" language: python - description: 'Retrieves points that are closer to stored positive examples and further from negative examples. - - Results are grouped by the specified payload field. - -' + description: Retrieves points that are closer to stored positive examples and further from negative examples. Results are grouped by the specified payload field. summary: Recommend point groups tags: - Search @@ -849,7 +832,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nfilter_ = models.Filter(\n must=[\n models.FieldCondition(\n key=\"city\",\n match=models.MatchValue(\n value=\"London\",\n ),\n )\n ]\n)\n\nsearch_queries = [\n models.SearchRequest(vector=[0.2, 0.1, 0.9, 0.7], filter=filter_, limit=3),\n models.SearchRequest(vector=[0.5, 0.3, 0.2, 0.3], filter=filter_, limit=3),\n]\n\nclient.search_batch(collection_name=\"{collection_name}\", requests=search_queries)\n" language: python - description: Retrieves the closest points in batches based on vector similarity and given filtering conditions + description: Retrieves the closest points in batches based on vector similarity and given filtering conditions. summary: Search batch points tags: - Search @@ -893,7 +876,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient, models\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.update_vectors(\n collection_name=\"{collection_name}\",\n points=[\n models.PointVectors(\n id=1,\n vector={\n \"image\": [0.1, 0.2, 0.3, 0.4],\n },\n ),\n models.PointVectors(\n id=2,\n vector={\n \"text\": [0.9, 0.8, 0.7, 0.6, 0.5, 0.4, 0.3, 0.2],\n },\n ),\n ],\n)\n" language: python - description: Update specified named vectors on points, keep unspecified vectors intact. + description: Updates specified vectors on points. All other unspecified vectors will stay intact. summary: Update vectors tags: - Points @@ -923,7 +906,7 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.delete_vectors(\n collection_name=\"{collection_name}\",\n points=[0, 3, 100],\n vectors=[\"text\", \"image\"],\n)\n" language: python - description: Delete named vectors from the given points. + description: Deletes specified vectors from points. All other unspecified vectors will stay intact. summary: Delete vectors tags: - Points @@ -953,7 +936,8 @@ paths: ' language: python - summary: Create shard key + description: Creates one or more shard keys for a specified collection. + summary: Create a shard key tags: - Distributed /collections/{collection_name}/shards/delete: @@ -982,7 +966,8 @@ paths: ' language: python - summary: Delete shard key + description: Deletes one or more shard keys for a specified collection. + summary: Delete a shard key tags: - Distributed /collections/{collection_name}/snapshots: @@ -1035,8 +1020,8 @@ paths: ' language: python - description: Get list of snapshots for a collection - summary: List collection snapshots + description: Retrieves a list of all snapshots for a specified collection. + summary: List all snapshots (collection) tags: - Snapshots post: @@ -1088,8 +1073,8 @@ paths: ' language: python - description: Create new snapshot for a collection - summary: Create collection snapshot + description: Creates a new snapshot for a specified collection. + summary: Create a snapshot (collection) tags: - Snapshots /collections/{collection_name}/snapshots/recover: @@ -1101,8 +1086,8 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.recover_snapshot(\n \"{collection_name}\",\n \"http://example.com/path/to/snapshot.shapshot\",\n)\n" language: python - description: Recover local collection data from a snapshot. This will overwrite any data, stored on this node, for the collection. If collection does not exist - it will be created. - summary: Recover from a snapshot + description: Recovers local collection data from a snapshot. This will overwrite any collection data stored on the node. If the collection does not exist, it will be created. + summary: Recover from a snapshot (collection) tags: - Snapshots /collections/{collection_name}/snapshots/{snapshot_name}: @@ -1139,13 +1124,13 @@ paths: - code-samples: - code: "from qdrant_client import QdrantClient\n\nclient = QdrantClient(url=\"http://localhost:6333\")\n\nclient.delete_snapshot(\n collection_name=\"{collection_name}\", snapshot_name=\"{snapshot_name}\"\n)\n" language: python - description: Delete snapshot for a collection - summary: Delete collection snapshot + description: Deletes the specified snapshot for a collection. + summary: Delete a snapshot (collection) tags: - Snapshots get: - description: Download specified snapshot from a collection as a file - summary: Download collection snapshot + description: Downloads the specified snapshot file from a collection. + summary: Download a snapshot (collection) tags: - Snapshots /snapshots: @@ -1198,8 +1183,8 @@ paths: ' language: python - description: Get list of snapshots of the whole storage - summary: List of storage snapshots + description: Returns a list of all snapshots for the entire storage. + summary: List all snapshots (storage) tags: - Snapshots post: @@ -1251,8 +1236,8 @@ paths: ' language: python - description: Create new snapshot of the whole storage - summary: Create storage snapshot + description: Creates a new snapshot of the entire storage. + summary: Create a snapshot (storage) tags: - Snapshots /snapshots/{snapshot_name}: @@ -1305,153 +1290,151 @@ paths: ' language: python - description: Delete snapshot of the whole storage - summary: Delete storage snapshot + description: Deletes the specified snapshot of the entire storage. + summary: Delete a snapshot (storage) tags: - Snapshots get: - description: Download specified snapshot of the whole storage as a file - summary: Download storage snapshot + description: Downloads the specified snapshot of the entire storage as a file. + summary: Download a snapshot (storage) tags: - Snapshots /: get: description: Returns details about the running Qdrant instance. - summary: Returns information about the running Qdrant instance + summary: Retrieve instance details tags: - Service /cluster: get: - description: Get information about the current state and composition of the cluster - summary: Get cluster status info + description: Returns information about the cluster's current state and composition. + summary: Check cluster status tags: - Distributed /cluster/peer/{peer_id}: delete: - description: Tries to remove peer from the cluster. Will return an error if peer has shards on it. - summary: Remove peer from the cluster + description: Attempts to remove the node from the cluster. This endpoint returns an error if the node (peer) has shards on it. + summary: Remove peer from cluster tags: - Distributed /cluster/recover: post: - summary: Tries to recover current peer Raft state. + description: Attempts to restore or synchronize the node's current state with that of its peers. + summary: Recover cluster state tags: - Distributed /collections/{collection_name}/cluster: get: - description: Get cluster information for a collection - summary: Collection cluster info + description: Retrieves cluster details for a specified collection. + summary: Retrieve cluster details tags: - Distributed post: - summary: Update collection cluster setup + description: Updates the cluster configuration for a specified collection. + summary: Update cluster setup tags: - Distributed /collections/{collection_name}/exists: get: - description: Returns "true" if the given collection name exists, and "false" otherwise - summary: Check the existence of a collection + description: Checks whether the specified collection exists. + summary: Check collection existence tags: - Collections /collections/{collection_name}/points/{id}: get: - description: Retrieve full information of single point by id - summary: Get point + description: Retrieves all details from a single point. + summary: Retrieve a point tags: - Points /collections/{collection_name}/shards/{shard_id}/snapshots: get: - description: Get list of snapshots for a shard of a collection - summary: List shards snapshots for a collection + description: Returns a list of all snapshots for a shard from a collection. + summary: List all snapshots (shard) tags: - Snapshots post: - description: Create new snapshot of a shard for a collection - summary: Create shard snapshot + description: Creates a new snapshot of a shard from a collection. + summary: Create a snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/recover: put: - description: Recover shard of a local collection data from a snapshot. This will overwrite any data, stored in this shard, for the collection. - summary: Recover from a snapshot + description: Recovers the shard of a local collection from a snapshot. This will overwrite any collection data, which is stored in this shard. + summary: Recover from snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/upload: post: - description: Recover shard of a local collection from an uploaded snapshot. This will overwrite any data, stored on this node, for the collection shard. - summary: Recover shard from an uploaded snapshot + description: Recovers the shard of a local collection from an uploaded snapshot. This will overwrite any collection data, which is stored in this shard. + summary: Recover from uploaded snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/{snapshot_name}: delete: - description: Delete snapshot of a shard for a collection - summary: Delete shard snapshot + description: Deletes the specified snapshot of a shard from a collection. + summary: Delete a snapshot (shard) tags: - Snapshots get: - description: Download specified snapshot of a shard from a collection as a file - summary: Download collection snapshot + description: Downloads the specified snapshot of a shard from a collection as a file. + summary: Download a snapshot (shard) tags: - Snapshots /collections/{collection_name}/snapshots/upload: post: - description: Recover local collection data from an uploaded snapshot. This will overwrite any data, stored on this node, for the collection. If collection does not exist - it will be created. - summary: Recover from an uploaded snapshot + description: Recovers local collection data from an uploaded snapshot. This will overwrite any collection data stored on the node. If the collection does not exist, it will be created. + summary: Recover from an uploaded snapshot (collection) tags: - Snapshots /healthz: get: - description: Checks the health of individual service instance. - summary: Kubernetes healthz endpoint + description: Monitors the health of individual containers. + summary: Kubernetes health check tags: - Service /issues: delete: - description: Removes all issues reported so far + description: Removes all issues reported so far. summary: Clear issues tags: - Beta get: - description: Get a report of performance issues and configuration suggestions - summary: Get issues + description: Retrieves a report of performance issues and configuration suggestions. + summary: Report issues tags: - Beta /livez: get: - description: Checks the health of individual service instance. - summary: Kubernetes livez endpoint + description: Monitors the container responsiveness and alerts in case of failure. + summary: Kubernetes liveness probe tags: - Service /locks: get: description: Retrieves the current lock setting. If write is false, all write operations and collection creation are restricted. - summary: Get lock options + summary: Check write protection tags: - Service post: description: Restricts all write operations and forbids collection creation. This endpoint also returns previous lock options. - summary: Set lock options + summary: Set write protection tags: - Service /metrics: get: - description: 'Collect metrics data, such as: application info, collection info, cluster info and statistics. - -' + description: 'Collect metrics data, such as: application info, collection info, cluster info and statistics.' summary: Collect Prometheus metrics data tags: - Service /readyz: get: - description: Checks the service to see when it can start accepting traffic. - summary: Kubernetes readyz endpoint + description: Monitors the container to see when it can start accepting traffic. + summary: Kubernetes readiness probe tags: - Service /telemetry: get: - description: 'Collects telemetry data, such as: application info, system info, collection info, cluster info, configs and statistics." - -' + description: 'Collects telemetry data, such as: application info, system info, collection info, cluster info, configs and statistics.' summary: Collect telemetry data tags: - Service From 18aebcf90049f2959a8419e71886669bbe48f338 Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Wed, 22 May 2024 20:39:13 -0700 Subject: [PATCH 03/17] update one endpoint --- fern/api-description-overwrites.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fern/api-description-overwrites.yml b/fern/api-description-overwrites.yml index dd0ff28..cbeac21 100644 --- a/fern/api-description-overwrites.yml +++ b/fern/api-description-overwrites.yml @@ -48,8 +48,8 @@ paths: tags: - Collections get: - description: Retrieves details about the specified collection. - summary: Get collection parameters + description: Retrieves parameters from the specified collection. + summary: Get collection details tags: - Collections patch: From fb455d16f3daca495d7835a8f2488633b9e537cc Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Thu, 23 May 2024 03:40:19 +0000 Subject: [PATCH 04/17] Sync OpenAPI --- fern/apis/master/openapi-overrides.yml | 4 ++-- fern/apis/v1.9.x/openapi-overrides.yml | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/fern/apis/master/openapi-overrides.yml b/fern/apis/master/openapi-overrides.yml index 19710f3..e085248 100644 --- a/fern/apis/master/openapi-overrides.yml +++ b/fern/apis/master/openapi-overrides.yml @@ -262,8 +262,8 @@ paths: ' language: python - description: Retrieves details about the specified collection. - summary: Get collection parameters + description: Retrieves parameters from the specified collection. + summary: Get collection details tags: - Collections patch: diff --git a/fern/apis/v1.9.x/openapi-overrides.yml b/fern/apis/v1.9.x/openapi-overrides.yml index 19710f3..e085248 100644 --- a/fern/apis/v1.9.x/openapi-overrides.yml +++ b/fern/apis/v1.9.x/openapi-overrides.yml @@ -262,8 +262,8 @@ paths: ' language: python - description: Retrieves details about the specified collection. - summary: Get collection parameters + description: Retrieves parameters from the specified collection. + summary: Get collection details tags: - Collections patch: From e7dae28fa31f67b995893ff94bb27c5e4a068dee Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Wed, 22 May 2024 20:45:03 -0700 Subject: [PATCH 05/17] fix article in title --- fern/api-description-overwrites.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fern/api-description-overwrites.yml b/fern/api-description-overwrites.yml index cbeac21..b90177f 100644 --- a/fern/api-description-overwrites.yml +++ b/fern/api-description-overwrites.yml @@ -259,13 +259,13 @@ Target Search: When a target is provided (with or without context), the score co /collections/{collection_name}/shards/{shard_id}/snapshots/recover: put: description: Recovers the shard of a local collection from a snapshot. This will overwrite any collection data, which is stored in this shard. - summary: Recover from snapshot (shard) + summary: Recover from a snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/upload: post: description: Recovers the shard of a local collection from an uploaded snapshot. This will overwrite any collection data, which is stored in this shard. - summary: Recover from uploaded snapshot (shard) + summary: Recover from an uploaded snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/{snapshot_name}: From bd8911c568e750d5a64c1604d5567d7c3b9c8fd3 Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Thu, 23 May 2024 03:45:25 +0000 Subject: [PATCH 06/17] Sync OpenAPI --- fern/apis/master/openapi-overrides.yml | 4 ++-- fern/apis/v1.9.x/openapi-overrides.yml | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/fern/apis/master/openapi-overrides.yml b/fern/apis/master/openapi-overrides.yml index e085248..2cd87cf 100644 --- a/fern/apis/master/openapi-overrides.yml +++ b/fern/apis/master/openapi-overrides.yml @@ -1360,13 +1360,13 @@ paths: /collections/{collection_name}/shards/{shard_id}/snapshots/recover: put: description: Recovers the shard of a local collection from a snapshot. This will overwrite any collection data, which is stored in this shard. - summary: Recover from snapshot (shard) + summary: Recover from a snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/upload: post: description: Recovers the shard of a local collection from an uploaded snapshot. This will overwrite any collection data, which is stored in this shard. - summary: Recover from uploaded snapshot (shard) + summary: Recover from an uploaded snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/{snapshot_name}: diff --git a/fern/apis/v1.9.x/openapi-overrides.yml b/fern/apis/v1.9.x/openapi-overrides.yml index e085248..2cd87cf 100644 --- a/fern/apis/v1.9.x/openapi-overrides.yml +++ b/fern/apis/v1.9.x/openapi-overrides.yml @@ -1360,13 +1360,13 @@ paths: /collections/{collection_name}/shards/{shard_id}/snapshots/recover: put: description: Recovers the shard of a local collection from a snapshot. This will overwrite any collection data, which is stored in this shard. - summary: Recover from snapshot (shard) + summary: Recover from a snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/upload: post: description: Recovers the shard of a local collection from an uploaded snapshot. This will overwrite any collection data, which is stored in this shard. - summary: Recover from uploaded snapshot (shard) + summary: Recover from an uploaded snapshot (shard) tags: - Snapshots /collections/{collection_name}/shards/{shard_id}/snapshots/{snapshot_name}: From 0abbfda94c65cb5751b01e5d0ac1da306770362e Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Thu, 23 May 2024 15:36:39 -0700 Subject: [PATCH 07/17] add front page --- fern/docs.yml | 3 +++ fern/pages/api-summary.mdx | 9 +++++++++ 2 files changed, 12 insertions(+) create mode 100644 fern/pages/api-summary.mdx diff --git a/fern/docs.yml b/fern/docs.yml index 9d91e81..427c183 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -31,3 +31,6 @@ navbar-links: - type: outlined text: GitHub url: https://github.com/qdrant/qdrant +navigation: + - api: API Reference + summary: ./pages/api-summary.mdx \ No newline at end of file diff --git a/fern/pages/api-summary.mdx b/fern/pages/api-summary.mdx new file mode 100644 index 0000000..afdb7b5 --- /dev/null +++ b/fern/pages/api-summary.mdx @@ -0,0 +1,9 @@ +# API Reference + +This document describes CRUD and search operations on collections of points (vectors with payload). + +Qdrant supports any combinations of `should`, `min_should`, `must` and `must_not` conditions. +This makes it possible to use in applications when object could not be described solely by vector. +It could be location features, availability flags, and other custom properties businesses should take into account. + +Read Qdrant [documentation](https://qdrant.tech/documentation/) to learn more about vector search and its applications. \ No newline at end of file From df44763812b2a82b93913a44fe06f947321e8cf5 Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Thu, 23 May 2024 22:37:02 +0000 Subject: [PATCH 08/17] Sync OpenAPI --- fern/docs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/docs.yml b/fern/docs.yml index 427c183..8706ae1 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -33,4 +33,4 @@ navbar-links: url: https://github.com/qdrant/qdrant navigation: - api: API Reference - summary: ./pages/api-summary.mdx \ No newline at end of file + summary: ./pages/api-summary.mdx From 50a2f91d3c0dfea91b380e6589b2953f0737f4ba Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Thu, 23 May 2024 17:37:46 -0700 Subject: [PATCH 09/17] update sample intro and object description --- fern/docs.yml | 3 --- fern/fern.config.json | 2 +- fern/pages/api-summary.mdx | 28 ++++++++++++++++++++++------ fern/pages/collections.mdx | 20 ++++++++++++++++++++ fern/versions/master.yml | 8 ++++++++ 5 files changed, 51 insertions(+), 10 deletions(-) create mode 100644 fern/pages/collections.mdx diff --git a/fern/docs.yml b/fern/docs.yml index 427c183..9d91e81 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -31,6 +31,3 @@ navbar-links: - type: outlined text: GitHub url: https://github.com/qdrant/qdrant -navigation: - - api: API Reference - summary: ./pages/api-summary.mdx \ No newline at end of file diff --git a/fern/fern.config.json b/fern/fern.config.json index 20725ce..c51c4c8 100644 --- a/fern/fern.config.json +++ b/fern/fern.config.json @@ -1,4 +1,4 @@ { "organization": "qdrant", - "version": "0.23.1" + "version": "0.29.0" } \ No newline at end of file diff --git a/fern/pages/api-summary.mdx b/fern/pages/api-summary.mdx index afdb7b5..75c488f 100644 --- a/fern/pages/api-summary.mdx +++ b/fern/pages/api-summary.mdx @@ -1,9 +1,25 @@ -# API Reference +Qdrant is a [vector database](https://qdrant.tech/documentation/overview/) and a [semantic search](https://qdrant.tech/documentation/overview/vector-search/) engine. You can use its REST API to develop a production-ready service to store, search, and manage vectors with an additional payload. -This document describes CRUD and search operations on collections of points (vectors with payload). +## How does Qdrant work? -Qdrant supports any combinations of `should`, `min_should`, `must` and `must_not` conditions. -This makes it possible to use in applications when object could not be described solely by vector. -It could be location features, availability flags, and other custom properties businesses should take into account. +1. First, you should create a [collection](/api-reference/collections/the-collection-object) to store all your data. +2. Then upsert data [points](/api-reference/points/upsert-points) and enrich them with a custom [payload](/api-reference/points/set-payload). +3. With a full collection, run a [search](/api-reference/search/points) to find relevant results. +4. Collections can be [snapshotted, downloaded and restored](/api-reference/snapshots/list-snapshots). +5. When ready, setup a [distributed system](/api-reference/distributed/create-shard-key) for production. -Read Qdrant [documentation](https://qdrant.tech/documentation/) to learn more about vector search and its applications. \ No newline at end of file +### Just getting started? +Try the [development quickstart](https://qdrant.tech/documentation/quick-start/) guide. + + diff --git a/fern/pages/collections.mdx b/fern/pages/collections.mdx new file mode 100644 index 0000000..f762613 --- /dev/null +++ b/fern/pages/collections.mdx @@ -0,0 +1,20 @@ +A collection is a logical grouping for related [points](https://qdrant.tech/documentation/concepts/points/). Each collection can be thought of as a dataset within the database, where you can store, organize, and manage points that share a common purpose or are related in some way. +Each point in a collection consists of one or more vectors with a [payload](https://qdrant.tech/documentation/concepts/payload/). + +When querying a vector database, you need to specify the collection you want to [search](https://qdrant.tech/documentation/concepts/search/) within. + +Each Qdrant collection has configurable parameters for optimization, index construction, and vacuum. + +Read more: [Collections](https://qdrant.tech/documentation/concepts/collections/) + + \ No newline at end of file diff --git a/fern/versions/master.yml b/fern/versions/master.yml index 3850636..92b02b3 100644 --- a/fern/versions/master.yml +++ b/fern/versions/master.yml @@ -1,3 +1,11 @@ navigation: - api: API Reference api-name: master + summary: ../pages/api-summary.mdx + layout: + - collections: + - page: The Collection object + path: ../pages/collections.mdx + + + \ No newline at end of file From 97b6332f9119a94de3ee4d1fca6408130336d9ed Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Fri, 24 May 2024 00:40:06 +0000 Subject: [PATCH 10/17] Sync OpenAPI --- fern/versions/v1.9.x.yml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/fern/versions/v1.9.x.yml b/fern/versions/v1.9.x.yml index d0ab568..c27135c 100644 --- a/fern/versions/v1.9.x.yml +++ b/fern/versions/v1.9.x.yml @@ -1,3 +1,11 @@ navigation: - api: API Reference api-name: v1.9.x + summary: ../pages/api-summary.mdx + layout: + - collections: + - page: The Collection object + path: ../pages/collections.mdx + + + \ No newline at end of file From b2eb5b5d9b9e04580272a4be62d66bf39d2deffc Mon Sep 17 00:00:00 2001 From: David Myriel Date: Thu, 23 May 2024 17:47:04 -0700 Subject: [PATCH 11/17] Update fern/api-description-overwrites.yml Co-authored-by: Andrey Vasnetsov --- fern/api-description-overwrites.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/api-description-overwrites.yml b/fern/api-description-overwrites.yml index b90177f..de2d580 100644 --- a/fern/api-description-overwrites.yml +++ b/fern/api-description-overwrites.yml @@ -315,7 +315,7 @@ Target Search: When a target is provided (with or without context), the score co - Snapshots /healthz: get: - description: Monitors the health of individual containers. + description: Checks the health of individual instance. summary: Kubernetes health check tags: - Service From 66d2f5d9068e909425d93a7e8df11e25827dafdb Mon Sep 17 00:00:00 2001 From: David Myriel Date: Thu, 23 May 2024 17:47:12 -0700 Subject: [PATCH 12/17] Update fern/api-description-overwrites.yml Co-authored-by: Andrey Vasnetsov --- fern/api-description-overwrites.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/api-description-overwrites.yml b/fern/api-description-overwrites.yml index de2d580..c88836c 100644 --- a/fern/api-description-overwrites.yml +++ b/fern/api-description-overwrites.yml @@ -355,7 +355,7 @@ Target Search: When a target is provided (with or without context), the score co - Service /readyz: get: - description: Monitors the container to see when it can start accepting traffic. + description: Checks the instance to see when it can start accepting traffic. summary: Kubernetes readiness probe tags: - Service From a461d990d8ec79f2cfdd6962e8bd64fa559c4a6c Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Fri, 24 May 2024 00:47:23 +0000 Subject: [PATCH 13/17] Sync OpenAPI --- fern/apis/master/openapi-overrides.yml | 2 +- fern/apis/v1.9.x/openapi-overrides.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/fern/apis/master/openapi-overrides.yml b/fern/apis/master/openapi-overrides.yml index 2cd87cf..7d05137 100644 --- a/fern/apis/master/openapi-overrides.yml +++ b/fern/apis/master/openapi-overrides.yml @@ -1388,7 +1388,7 @@ paths: - Snapshots /healthz: get: - description: Monitors the health of individual containers. + description: Checks the health of individual instance. summary: Kubernetes health check tags: - Service diff --git a/fern/apis/v1.9.x/openapi-overrides.yml b/fern/apis/v1.9.x/openapi-overrides.yml index 2cd87cf..7d05137 100644 --- a/fern/apis/v1.9.x/openapi-overrides.yml +++ b/fern/apis/v1.9.x/openapi-overrides.yml @@ -1388,7 +1388,7 @@ paths: - Snapshots /healthz: get: - description: Monitors the health of individual containers. + description: Checks the health of individual instance. summary: Kubernetes health check tags: - Service From 86d1ce6bfedd887b330b24883fe790c8d023caaf Mon Sep 17 00:00:00 2001 From: Andrey Vasnetsov Date: Wed, 29 May 2024 13:14:27 +0200 Subject: [PATCH 14/17] Update fern/api-description-overwrites.yml Co-authored-by: Anush --- fern/api-description-overwrites.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/api-description-overwrites.yml b/fern/api-description-overwrites.yml index c88836c..ce59052 100644 --- a/fern/api-description-overwrites.yml +++ b/fern/api-description-overwrites.yml @@ -170,7 +170,7 @@ Target Search: When a target is provided (with or without context), the score co description: Retrieves points that are closer to stored positive examples and further from negative examples. summary: Recommend points tags: - - Points + - Search /collections/{collection_name}/points/recommend/batch: post: description: Retrieves points in batches that are closer to stored positive examples and further from negative examples. From a0382516a428b1d7bb2b0fdf18077cb225897673 Mon Sep 17 00:00:00 2001 From: generall Date: Wed, 29 May 2024 11:14:44 +0000 Subject: [PATCH 15/17] Sync OpenAPI --- fern/apis/master/openapi-overrides.yml | 4 +- fern/apis/master/openapi.json | 88 ++++++++++++++++++++------ fern/apis/v1.9.x/openapi-overrides.yml | 4 +- qdrant | 2 +- 4 files changed, 75 insertions(+), 23 deletions(-) diff --git a/fern/apis/master/openapi-overrides.yml b/fern/apis/master/openapi-overrides.yml index 7d05137..a2a81b3 100644 --- a/fern/apis/master/openapi-overrides.yml +++ b/fern/apis/master/openapi-overrides.yml @@ -717,7 +717,7 @@ paths: description: Retrieves points that are closer to stored positive examples and further from negative examples. summary: Recommend points tags: - - Points + - Search /collections/{collection_name}/points/recommend/batch: post: x-fern-examples: @@ -1428,7 +1428,7 @@ paths: - Service /readyz: get: - description: Monitors the container to see when it can start accepting traffic. + description: Checks the instance to see when it can start accepting traffic. summary: Kubernetes readiness probe tags: - Service diff --git a/fern/apis/master/openapi.json b/fern/apis/master/openapi.json index 788ecc4..2d7c710 100644 --- a/fern/apis/master/openapi.json +++ b/fern/apis/master/openapi.json @@ -5719,7 +5719,8 @@ "type": "string", "enum": [ "float32", - "uint8" + "uint8", + "float16" ] }, "MultiVectorConfig": { @@ -6316,7 +6317,7 @@ ], "properties": { "indices": { - "description": "indices must be unique", + "description": "Indices must be unique", "type": "array", "items": { "type": "integer", @@ -6325,7 +6326,7 @@ } }, "values": { - "description": "values and indices must be the same length", + "description": "Values and indices must be the same length", "type": "array", "items": { "type": "number", @@ -6483,11 +6484,20 @@ "properties": { "should": { "description": "At least one of those conditions should match", - "type": "array", - "items": { - "$ref": "#/components/schemas/Condition" - }, - "nullable": true + "anyOf": [ + { + "$ref": "#/components/schemas/Condition" + }, + { + "type": "array", + "items": { + "$ref": "#/components/schemas/Condition" + } + }, + { + "nullable": true + } + ] }, "min_should": { "description": "At least minimum amount of given conditions should match", @@ -6502,19 +6512,37 @@ }, "must": { "description": "All conditions must match", - "type": "array", - "items": { - "$ref": "#/components/schemas/Condition" - }, - "nullable": true + "anyOf": [ + { + "$ref": "#/components/schemas/Condition" + }, + { + "type": "array", + "items": { + "$ref": "#/components/schemas/Condition" + } + }, + { + "nullable": true + } + ] }, "must_not": { "description": "All conditions must NOT match", - "type": "array", - "items": { - "$ref": "#/components/schemas/Condition" - }, - "nullable": true + "anyOf": [ + { + "$ref": "#/components/schemas/Condition" + }, + { + "type": "array", + "items": { + "$ref": "#/components/schemas/Condition" + } + }, + { + "nullable": true + } + ] } }, "additionalProperties": false @@ -7121,9 +7149,32 @@ "nullable": true } ] + }, + "order_value": { + "description": "Order-by value", + "anyOf": [ + { + "$ref": "#/components/schemas/OrderValue" + }, + { + "nullable": true + } + ] } } }, + "OrderValue": { + "anyOf": [ + { + "type": "integer", + "format": "int64" + }, + { + "type": "number", + "format": "double" + } + ] + }, "UpdateResult": { "type": "object", "required": [ @@ -9341,6 +9392,7 @@ "type": "string", "enum": [ "float32", + "float16", "uint8" ] }, diff --git a/fern/apis/v1.9.x/openapi-overrides.yml b/fern/apis/v1.9.x/openapi-overrides.yml index 7d05137..a2a81b3 100644 --- a/fern/apis/v1.9.x/openapi-overrides.yml +++ b/fern/apis/v1.9.x/openapi-overrides.yml @@ -717,7 +717,7 @@ paths: description: Retrieves points that are closer to stored positive examples and further from negative examples. summary: Recommend points tags: - - Points + - Search /collections/{collection_name}/points/recommend/batch: post: x-fern-examples: @@ -1428,7 +1428,7 @@ paths: - Service /readyz: get: - description: Monitors the container to see when it can start accepting traffic. + description: Checks the instance to see when it can start accepting traffic. summary: Kubernetes readiness probe tags: - Service diff --git a/qdrant b/qdrant index 34f7f8e..671cf97 160000 --- a/qdrant +++ b/qdrant @@ -1 +1 @@ -Subproject commit 34f7f8ec2d8455c0b3fe0f1fb134907ba7816a08 +Subproject commit 671cf97bc27ac2d6f5c35bf5d4a20afad43291b3 From e48afc4993887942339fb9a708e29570bb586d96 Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Wed, 29 May 2024 05:09:07 -0700 Subject: [PATCH 16/17] remove collection description --- fern/pages/api-summary.mdx | 2 +- fern/pages/collections.mdx | 20 -------------------- fern/versions/master.yml | 5 +---- fern/versions/v1.9.x.yml | 6 ------ 4 files changed, 2 insertions(+), 31 deletions(-) delete mode 100644 fern/pages/collections.mdx diff --git a/fern/pages/api-summary.mdx b/fern/pages/api-summary.mdx index 75c488f..6527dfb 100644 --- a/fern/pages/api-summary.mdx +++ b/fern/pages/api-summary.mdx @@ -15,7 +15,7 @@ Try the [development quickstart](https://qdrant.tech/documentation/quick-start/) ## Client Libraries |Client|Repository|Installation| |-|-|-| -|![python](https://qdrant.tech/docs/misc/python.webp)|**[Python](https://github.com/qdrant/qdrant-client)**|`pip install qdrant-client[fastembed]`| +|![python](https://qdrant.tech/docs/misc/python.webp)|**[Python](https://github.com/qdrant/qdrant-client)**|`pip install qdrant-client`| |![typescript](https://qdrant.tech/docs/misc/ts.webp)|**[Typescript](https://github.com/qdrant/qdrant-js)**|`npm install @qdrant/js-client-rest`| |![rust](https://qdrant.tech/docs/misc/rust.png)|**[Rust](https://github.com/qdrant/rust-client)**|`cargo add qdrant-client`| |![golang](https://qdrant.tech/docs/misc/go.webp)|**[Go](https://github.com/qdrant/go-client)**|`go get github.com/qdrant/go-client`| diff --git a/fern/pages/collections.mdx b/fern/pages/collections.mdx deleted file mode 100644 index f762613..0000000 --- a/fern/pages/collections.mdx +++ /dev/null @@ -1,20 +0,0 @@ -A collection is a logical grouping for related [points](https://qdrant.tech/documentation/concepts/points/). Each collection can be thought of as a dataset within the database, where you can store, organize, and manage points that share a common purpose or are related in some way. -Each point in a collection consists of one or more vectors with a [payload](https://qdrant.tech/documentation/concepts/payload/). - -When querying a vector database, you need to specify the collection you want to [search](https://qdrant.tech/documentation/concepts/search/) within. - -Each Qdrant collection has configurable parameters for optimization, index construction, and vacuum. - -Read more: [Collections](https://qdrant.tech/documentation/concepts/collections/) - - \ No newline at end of file diff --git a/fern/versions/master.yml b/fern/versions/master.yml index 92b02b3..155925e 100644 --- a/fern/versions/master.yml +++ b/fern/versions/master.yml @@ -2,10 +2,7 @@ navigation: - api: API Reference api-name: master summary: ../pages/api-summary.mdx - layout: - - collections: - - page: The Collection object - path: ../pages/collections.mdx + \ No newline at end of file diff --git a/fern/versions/v1.9.x.yml b/fern/versions/v1.9.x.yml index c27135c..564e0a9 100644 --- a/fern/versions/v1.9.x.yml +++ b/fern/versions/v1.9.x.yml @@ -2,10 +2,4 @@ navigation: - api: API Reference api-name: v1.9.x summary: ../pages/api-summary.mdx - layout: - - collections: - - page: The Collection object - path: ../pages/collections.mdx - - \ No newline at end of file From fa210a1a79ad0244add977adef28d4404c791b0e Mon Sep 17 00:00:00 2001 From: davidmyriel Date: Wed, 29 May 2024 12:09:36 +0000 Subject: [PATCH 17/17] Sync OpenAPI --- fern/versions/v1.9.x.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/fern/versions/v1.9.x.yml b/fern/versions/v1.9.x.yml index 564e0a9..57994bb 100644 --- a/fern/versions/v1.9.x.yml +++ b/fern/versions/v1.9.x.yml @@ -2,4 +2,7 @@ navigation: - api: API Reference api-name: v1.9.x summary: ../pages/api-summary.mdx + + + \ No newline at end of file