POST
/
vectors
curl --request POST \
  --url https://kb.bland.ai/vectors \
  --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 vector store. Make this a clear name that describes the contents of the store.

description
string
required

A description of the vector store. 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 vector store.

Will start with “KB-”.