Search Chunks
POST/v1/vector_stores/search
Authorization
Authorizationstringrequired
Bearer token for API authentication. Format: `Bearer YOUR_API_KEY`
Request Body
querystringrequired
Search query text
Constraints
•Minimum length: 1
vector_store_identifiersarray | null
IDs or names of vector stores to search
top_kintegerdefault:
10
Number of results to return
Constraints
•Minimum: 1
filtersSearchFilter | SearchFilterCondition | array
Optional filter conditions
file_idsarray | array
Optional list of file IDs to filter chunks by (inclusion filter)
Constraints
•Minimum items: 2•Maximum items: 2
search_optionsobject
Options for configuring vector store chunk searches.
Response Body
objectstringdefault:
list
The object type of the response
dataarrayrequired
The list of scored vector store file chunks
Delete Vector Store File
Delete a file from a vector store.
Search Files
Perform semantic search across complete vector store files. This endpoint searches through vector store files using semantic similarity matching. Unlike chunk search, it returns complete matching files rather than individual chunks. Supports complex search queries with filters and returns relevance-scored results.
Last updated: August 19, 2025