curl -X GET http://127.0.0.1:47334/api/projects/mindsdb/knowledge_bases

[
  {
    "id": 1,
    "name": "my_kb",
    "project_id": 1,
    "vector_database": "my_kb_chromadb",
    "vector_database_table": "default_collection",
    "updated_at": "2025-06-25 13:04:01.864625",
    "created_at": "2025-06-25 13:04:01.864624",
    "query_id": null,
    "embedding_model": null,
    "reranking_model": null,
    "metadata_columns": null,
    "content_columns": null,
    "id_column": null,
    "params": {
      "created_embedding_model": "kb_embedding_my_kb",
      "default_vector_storage": "my_kb_chromadb"
    },
    "project_name": "mindsdb"
  }
]

GET /api/projects/{project_name}/knowledge_bases

This API endpoint lists all available knowledge bases using the GET method.

Learn more about knowledge bases following this doc page.

​
Path Parameters

​
project_name
string
required

Defines the project where the knowledge bases are located. Note that the default project name is mindsdb.

​
Body

None.

​
Response

​
id
string
required

Unique identifier for the knowledge base.

​
name
string
required

The name assigned to the knowledge base.

​
project_id
string
required

The ID of the project where the knowledge base resides.

​
project_name
string
required

The name of the project where the knowledge base resides.

​
vector_database
string
required

The vector store used for storing vector embeddings.

​
vector_database_table
string
required

The name of the collection or table within the vector database.

​
updated_at
string
required

Timestamp indicating when the knowledge base was last updated.

​
created_at
string
required

Timestamp indicating when the knowledge base was created.

​
query_id
string
required

Optional field for linking specific queries to this knowledge base.

​
embedding_model
string
required

The embedding model used to convert content into vector representations.

​
reranking_model
string
required

Optional model used to rerank search results based on relevance.

​
metadata_columns
list
required

Optional list of columns used for metadata-based filtering or enrichment.

​
content_columns
list
required

Optional list of columns treated as the main content for embedding and retrieval.

​
id_column
string
required

The name of the column that uniquely identifies each content row.

​
params
object
required

A nested object that contains additional configuration parameters.

​
params.created_embedding_model
string
required

The name of the embedding model associated with this knowledge base at creation time.

​
params.default_vector_storage
string
required

The default storage used for storing vector data.

curl -X GET http://127.0.0.1:47334/api/projects/mindsdb/knowledge_bases

[
  {
    "id": 1,
    "name": "my_kb",
    "project_id": 1,
    "vector_database": "my_kb_chromadb",
    "vector_database_table": "default_collection",
    "updated_at": "2025-06-25 13:04:01.864625",
    "created_at": "2025-06-25 13:04:01.864624",
    "query_id": null,
    "embedding_model": null,
    "reranking_model": null,
    "metadata_columns": null,
    "content_columns": null,
    "id_column": null,
    "params": {
      "created_embedding_model": "kb_embedding_my_kb",
      "default_vector_storage": "my_kb_chromadb"
    },
    "project_name": "mindsdb"
  }
]