POST
/
api
/
knowledgebases
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
}'

​
Create Knowledgebase

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