Skip to main content
POST
/
api
/
knowledgebases
Create Knowledgebase
curl --request POST \
  --url https://app.pathors.com/api/knowledgebases \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "name": "<string>",
  "type": "<string>",
  "embeddingModelName": "<string>",
  "chunkSize": 123,
  "chunkOverlap": 123
}'
Creates a new knowledgebase for your project. Currently, each project is limited to one knowledgebase.

​
Endpoint

POST /api/knowledgebases

​
Headers

​
x-api-key
string
required
Your project API key for authentication

​
Request Body

​
name
string
required
Name of the knowledgebase
​
type
string
required
Type of the knowledgebase. Currently only supports “pgvector”
​
embeddingModelName
string
required
The embedding model to use. One of:
  • text-embedding-ada-002
  • text-embedding-3-small
  • text-embedding-3-large
​
chunkSize
number
Maximum size of text chunks in characters. Defaults to 500
​
chunkOverlap
number
Number of overlapping characters between adjacent chunks. Defaults to 50
Example request: 
{
  "name": "My Knowledge Base",
  "type": "pgvector",
  "embeddingModelName": "text-embedding-3-small",
  "chunkSize": 500,
  "chunkOverlap": 50
}

​
Response

A successful request will return a 201 status code with a success message. Example response: 
{
  "message": "Knowledgebase created successfully"
}

​
Error Responses

Status CodeDescription
400Invalid request body or validation error
401Invalid API key
500Internal server error

​
Usage Notes

  • Only one knowledgebase can exist per project
  • The embedding model cannot be changed after creation
  • Choose the embedding model based on your needs:
    • text-embedding-ada-002: Legacy model, good general purpose
    • text-embedding-3-small: Faster, more efficient
    • text-embedding-3-large: Most powerful, best quality