Document Store
Creates a new document store with the provided details
Unique identifier for the document store
Name of the document store
Description of the document store
Loaders associated with the document store, stored as JSON string
Places where the document store is used, stored as JSON string
Status of the document store
Configuration for the vector store, stored as JSON string
Configuration for the embedding, stored as JSON string
Configuration for the record manager, stored as JSON string
Date and time when the document store was created
Date and time when the document store was last updated
POST /document-store/store HTTP/1.1
Host:
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 296
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"description": "text",
"loaders": "text",
"whereUsed": "text",
"status": "EMPTY",
"vectorStoreConfig": "text",
"embeddingConfig": "text",
"recordManagerConfig": "text",
"createdDate": "2025-06-25T03:33:16.657Z",
"updatedDate": "2025-06-25T03:33:16.657Z"
}
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"description": "text",
"loaders": "text",
"whereUsed": "text",
"status": "EMPTY",
"vectorStoreConfig": "text",
"embeddingConfig": "text",
"recordManagerConfig": "text",
"createdDate": "2025-06-25T03:33:16.657Z",
"updatedDate": "2025-06-25T03:33:16.657Z"
}
Retrieves details of a specific document store by its ID
Document store ID
GET /document-store/store/{id} HTTP/1.1
Host:
Authorization: Bearer JWT
Accept: */*
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"description": "text",
"loaders": "text",
"whereUsed": "text",
"status": "EMPTY",
"vectorStoreConfig": "text",
"embeddingConfig": "text",
"recordManagerConfig": "text",
"createdDate": "2025-06-25T03:33:16.657Z",
"updatedDate": "2025-06-25T03:33:16.657Z"
}
Updates the details of a specific document store by its ID
Document store ID
Unique identifier for the document store
Name of the document store
Description of the document store
Loaders associated with the document store, stored as JSON string
Places where the document store is used, stored as JSON string
Status of the document store
Configuration for the vector store, stored as JSON string
Configuration for the embedding, stored as JSON string
Configuration for the record manager, stored as JSON string
Date and time when the document store was created
Date and time when the document store was last updated
PUT /document-store/store/{id} HTTP/1.1
Host:
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 296
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"description": "text",
"loaders": "text",
"whereUsed": "text",
"status": "EMPTY",
"vectorStoreConfig": "text",
"embeddingConfig": "text",
"recordManagerConfig": "text",
"createdDate": "2025-06-25T03:33:16.657Z",
"updatedDate": "2025-06-25T03:33:16.657Z"
}
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"description": "text",
"loaders": "text",
"whereUsed": "text",
"status": "EMPTY",
"vectorStoreConfig": "text",
"embeddingConfig": "text",
"recordManagerConfig": "text",
"createdDate": "2025-06-25T03:33:16.657Z",
"updatedDate": "2025-06-25T03:33:16.657Z"
}
Deletes a document store by its ID
Document store ID
DELETE /document-store/store/{id} HTTP/1.1
Host:
Authorization: Bearer JWT
Accept: */*
No content
Upsert document to document store
Document Store ID
Document ID within the store. If provided, existing configuration from the document will be used for the new document
Metadata associated with the document
{"foo":"bar"}
Whether to replace existing document loader with the new upserted chunks. However this does not delete the existing embeddings in the vector store
POST /document-store/upsert/{id} HTTP/1.1
Host:
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 359
{
"docId": "123e4567-e89b-12d3-a456-426614174000",
"metadata": {
"foo": "bar"
},
"replaceExisting": true,
"loader": {
"name": "plainText",
"config": {}
},
"splitter": {
"name": "recursiveCharacterTextSplitter",
"config": {}
},
"embedding": {
"name": "openAIEmbeddings",
"config": {}
},
"vectorStore": {
"name": "faiss",
"config": {}
},
"recordManager": {
"name": "postgresRecordManager",
"config": {}
}
}
{
"numAdded": 1,
"numDeleted": 1,
"numUpdated": 1,
"numSkipped": 1,
"addedDocs": [
{
"pageContent": "This is the content of the page.",
"metadata": {
"author": "John Doe",
"date": "2024-08-24"
}
}
]
}
Re-process and upsert all existing documents in document store
Document Store ID
POST /document-store/refresh/{id} HTTP/1.1
Host:
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 371
{
"items": [
{
"docId": "123e4567-e89b-12d3-a456-426614174000",
"metadata": {
"foo": "bar"
},
"replaceExisting": true,
"loader": {
"name": "plainText",
"config": {}
},
"splitter": {
"name": "recursiveCharacterTextSplitter",
"config": {}
},
"embedding": {
"name": "openAIEmbeddings",
"config": {}
},
"vectorStore": {
"name": "faiss",
"config": {}
},
"recordManager": {
"name": "postgresRecordManager",
"config": {}
}
}
]
}
No content
Retrieval query for the upserted chunks
Document store ID
603a7b51-ae7c-4b0a-8865-e454ed2f6766
Query to search for
What is the capital of France?
POST /document-store/vectorstore/query HTTP/1.1
Host:
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 91
{
"storeId": "603a7b51-ae7c-4b0a-8865-e454ed2f6766",
"query": "What is the capital of France?"
}
{
"timeTaken": 1,
"docs": [
{
"pageContent": "This is the content of the page.",
"metadata": {
"author": "John Doe",
"date": "2024-08-24"
}
}
]
}
Delete specific document loader and associated chunks from document store. This does not delete data from vector store.
Document Store ID
Document Loader ID
DELETE /document-store/loader/{storeId}/{loaderId} HTTP/1.1
Host:
Authorization: Bearer JWT
Accept: */*
No content
Only data that were upserted with Record Manager will be deleted from vector store
Document Store ID
DELETE /document-store/vectorstore/{id} HTTP/1.1
Host:
Authorization: Bearer JWT
Accept: */*
No content
Get chunks from a specific document loader within a document store
Document Store ID
Document loader ID
Pagination number
GET /document-store/chunks/{storeId}/{loaderId}/{pageNo} HTTP/1.1
Host:
Authorization: Bearer JWT
Accept: */*
{
"chunks": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"docId": "123e4567-e89b-12d3-a456-426614174000",
"storeId": "123e4567-e89b-12d3-a456-426614174000",
"chunkNo": 1,
"pageContent": "text",
"metadata": "text"
}
],
"count": 1,
"file": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"loaderId": "text",
"loaderName": "text",
"loaderConfig": {},
"splitterId": "text",
"splitterName": "text",
"splitterConfig": {},
"totalChunks": 1,
"totalChars": 1,
"status": "EMPTY",
"storeId": "text",
"files": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"mimePrefix": "text",
"size": 1,
"status": "EMPTY",
"uploaded": "2025-06-25T03:33:16.657Z"
}
],
"source": "text",
"credential": "text",
"rehydrated": true,
"preview": true,
"previewChunkCount": 1
},
"currentPage": 1,
"storeName": "text",
"description": "text"
}
Updates a specific chunk from a document loader
Document Store ID
Document Loader ID
Document Chunk ID
This is the content of the page.
PUT /document-store/chunks/{storeId}/{loaderId}/{chunkId} HTTP/1.1
Host:
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 103
{
"pageContent": "This is the content of the page.",
"metadata": {
"author": "John Doe",
"date": "2024-08-24"
}
}
{
"chunks": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"docId": "123e4567-e89b-12d3-a456-426614174000",
"storeId": "123e4567-e89b-12d3-a456-426614174000",
"chunkNo": 1,
"pageContent": "text",
"metadata": "text"
}
],
"count": 1,
"file": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"loaderId": "text",
"loaderName": "text",
"loaderConfig": {},
"splitterId": "text",
"splitterName": "text",
"splitterConfig": {},
"totalChunks": 1,
"totalChars": 1,
"status": "EMPTY",
"storeId": "text",
"files": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"mimePrefix": "text",
"size": 1,
"status": "EMPTY",
"uploaded": "2025-06-25T03:33:16.657Z"
}
],
"source": "text",
"credential": "text",
"rehydrated": true,
"preview": true,
"previewChunkCount": 1
},
"currentPage": 1,
"storeName": "text",
"description": "text"
}
Delete a specific chunk from a document loader
Document Store ID
Document Loader ID
Document Chunk ID
DELETE /document-store/chunks/{storeId}/{loaderId}/{chunkId} HTTP/1.1
Host:
Authorization: Bearer JWT
Accept: */*
No content
Last updated