Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation
Theme

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Vector Stores

Create vector store
vector_stores.create(**kwargs) -> VectorStore
POST
/vector_stores
Delete vector store
vector_stores.delete(vector_store_id) -> VectorStoreDeleted
DELETE
/vector_stores/{vector_store_id}
List vector stores
vector_stores.list(**kwargs) -> SyncCursorPage[VectorStore]
GET
/vector_stores
Retrieve vector store
vector_stores.retrieve(vector_store_id) -> VectorStore
GET
/vector_stores/{vector_store_id}
Search vector store
vector_stores.search(vector_store_id, **kwargs) -> SyncPage[VectorStoreSearchResponse]
POST
/vector_stores/{vector_store_id}/search
Modify vector store
vector_stores.update(vector_store_id, **kwargs) -> VectorStore
POST
/vector_stores/{vector_store_id}
Models
class AutoFileChunkingStrategyParam: …

The default strategy. This strategy currently uses a max_chunk_size_tokens of 800 and chunk_overlap_tokens of 400.

FileChunkingStrategy

The strategy used to chunk the file.

FileChunkingStrategyParam

The chunking strategy used to chunk the file(s). If not set, will use the auto strategy. Only applicable if file_ids is non-empty.

class OtherFileChunkingStrategyObject: …

This is returned when the chunking strategy is unknown. Typically, this is because the file was indexed before the chunking_strategy concept was introduced in the API.

class StaticFileChunkingStrategy: …
class StaticFileChunkingStrategyObject: …
class StaticFileChunkingStrategyObjectParam: …

Customize your own chunking strategy by setting chunk size and chunk overlap.

class VectorStore: …

A vector store is a collection of processed files can be used by the file_search tool.

class VectorStoreDeleted: …
class VectorStoreSearchResponse: …

Vector StoresFile Batches

Cancel vector store file batch
vector_stores.file_batches.cancel(batch_id, **kwargs) -> VectorStoreFileBatch
POST
/vector_stores/{vector_store_id}/file_batches/{batch_id}/cancel
Create vector store file batch
vector_stores.file_batches.create(vector_store_id, **kwargs) -> VectorStoreFileBatch
POST
/vector_stores/{vector_store_id}/file_batches
List vector store files in a batch
vector_stores.file_batches.list_files(batch_id, **kwargs) -> SyncCursorPage[VectorStoreFile]
GET
/vector_stores/{vector_store_id}/file_batches/{batch_id}/files
Retrieve vector store file batch
vector_stores.file_batches.retrieve(batch_id, **kwargs) -> VectorStoreFileBatch
GET
/vector_stores/{vector_store_id}/file_batches/{batch_id}
Models
class VectorStoreFileBatch: …

A batch of files attached to a vector store.

Vector StoresFiles

Retrieve vector store file content
vector_stores.files.content(file_id, **kwargs) -> SyncPage[FileContentResponse]
GET
/vector_stores/{vector_store_id}/files/{file_id}/content
Create vector store file
vector_stores.files.create(vector_store_id, **kwargs) -> VectorStoreFile
POST
/vector_stores/{vector_store_id}/files
Delete vector store file
vector_stores.files.delete(file_id, **kwargs) -> VectorStoreFileDeleted
DELETE
/vector_stores/{vector_store_id}/files/{file_id}
List vector store files
vector_stores.files.list(vector_store_id, **kwargs) -> SyncCursorPage[VectorStoreFile]
GET
/vector_stores/{vector_store_id}/files
Retrieve vector store file
vector_stores.files.retrieve(file_id, **kwargs) -> VectorStoreFile
GET
/vector_stores/{vector_store_id}/files/{file_id}
Update vector store file attributes
vector_stores.files.update(file_id, **kwargs) -> VectorStoreFile
POST
/vector_stores/{vector_store_id}/files/{file_id}
Models
class FileContentResponse: …
class VectorStoreFile: …

A list of files attached to a vector store.

class VectorStoreFileDeleted: …