Search Files
POST/v1/vector_stores/files/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 file searches.
Response Body
objectstringdefault:
list
The object type of the response
dataScoredVectorStoreFile[]required
The list of scored vector store files
Search Chunks
Perform semantic search across vector store chunks. This endpoint searches through vector store chunks using semantic similarity matching. It supports complex search queries with filters and returns relevance-scored results.
Question Answering
Question answering
Last updated: August 19, 2025