For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
CloudGitHub
  • API Reference
      • POSTSearch points
      • POSTSearch batch points
      • POSTSearch point groups
      • POSTRecommend points
      • POSTRecommend batch points
      • POSTRecommend point groups
      • POSTDiscover points
      • POSTDiscover batch points
LogoLogo
CloudGitHub
API ReferenceSearch

Discover batch points

POST
/collections/:collection_name/points/discover/batch
POST
/collections/:collection_name/points/discover/batch
$curl -X POST http://localhost:6333/collections/collection_name/points/discover/batch \
>     -H "api-key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "searches": [
>    {
>      "limit": 1
>    }
>  ]
>}'
200Successful
1{
2  "time": 1.1,
3  "status": "string",
4  "result": [
5    [
6      {
7        "id": 1,
8        "version": 1,
9        "score": 1.1,
10        "payload": {},
11        "vector": {},
12        "shard_key": "string"
13      }
14    ]
15  ]
16}

Retrieves points in batches based on the target and/or positive and negative example pairs.

Was this page helpful?
Previous

Create payload index

Next
Built with

Authentication

api-keystring
API Key authentication via header

Path parameters

collection_namestringRequired
Name of the collection to search in

Query parameters

consistencyinteger or enumOptional
Define read consistency guarantees for the operation
timeoutintegerOptional>=1
If set, overrides global timeout for this request. Unit is seconds.

Request

Batch request points based on { positive, negative } pairs of examples, and/or a target.

searcheslist of objectsRequired

Response

successful operation
timedouble
Time spent to process this request
statusstring
resultlist of lists of objects