POST
/
v1
/
knowledgebases
curl --request POST \
  --url https://api.bland.ai/v1/knowledgebases \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "name": "<string>",
  "description": "<string>",
  "text": "<string>"
}'
{
  "vector_id": "KB-55e64dae-1585-4632-ae97-c909c288c6bc"
}

Usage: Pass the vector_id into your agent’s tools to enable the agent to use the vector store.

"tools": [
    "KB-55e64dae-1585-4632-ae97-c909c288c6bc"
]

​
Headers

​
authorization
string
required

Your API key for authentication.

​
Body

​
name
string
required

The name of the knowledge base. Make this a clear name that describes the contents of the store.

​
description
string
required

A description of the knowledge base. This can be a longer description of the contents of the store, or what terms to use to search for vectors in the store.

This is visible to the AI, so making it descriptive can help the AI understand when to use it or not.

​
text
string
required

The full text document to be stored and vectorized.

​
Response

​
vector_id
string

The unique identifier for the knowledge base.

Will start with “KB-”.

{
  "vector_id": "KB-55e64dae-1585-4632-ae97-c909c288c6bc"
}