Search collection

POST 
/api/v1/collections/:collection-id/search

Perform a search in a collection.

Request

Path Parameters

collection-id stringrequired

Collection ID

application/json

Body

text stringrequired

Search query text

labels array[]nullable

Possible values: >= 2, <= 2

max_distance numbernullable

Default value: 0.65

Maximum similarity distance for the search results. Must be between 0 and 1.

top_k numbernullable

Default value: 5

Maximum number of search results

Responses

200

Successful response

application/json

Schema

Schema

result

object[]

required

Search results consisting of chunks

Array [

id stringrequired

Chunk ID

content stringrequired

Chunk content in plain text

file_id stringrequired

File ID which the chunk is part of

distance numberrequired

A value representing a similarity distance between query and result, smaller values means more similar.

score numbernullable

]

Example (from schema)

{
  "result": [
    {
      "id": "string",
      "content": "string",
      "file_id": "string",
      "distance": 0,
      "score": 0
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

error

object

required

message stringrequired

Human readable error message

data nullable

Further details on the error

Example (from schema)

{
  "error": {
    "message": "string"
  }
}

403

Forbidden

application/json

Schema

Schema

error

object

required

message stringrequired

Human readable error message

data nullable

Further details on the error

Example (from schema)

{
  "error": {
    "message": "string"
  }
}

404

Not found

application/json

Schema

Schema

error

object

required

message stringrequired

Human readable error message

data nullable

Further details on the error

Example (from schema)

{
  "error": {
    "message": "string"
  }
}

Loading...