curl -X GET http://127.0.0.1:47334/api/projects/mindsdb/knowledge_bases/my_kb
{
  "id": 2,
  "name": "my_kb",
  "project_id": 1,
  "vector_database": "my_kb_chromadb",
  "vector_database_table": "default_collection",
  "updated_at": "2025-06-26 10:24:06.311655",
  "created_at": "2025-06-26 10:24:06.311654",
  "query_id": null,
  "embedding_model": {
    "provider": "openai",
    "model_name": "text-embedding-3-small",
    "api_key": "******"
  },
  "reranking_model": {
    "provider": "openai",
    "model_name": "gpt-4o",
    "api_key": "******"
  },
  "metadata_columns": [
    "product"
  ],
  "content_columns": [
    "notes"
  ],
  "id_column": "order_id",
  "params": {
    "created_embedding_model": "kb_embedding_my_kb"
  }
}

GET /api/projects/{project_name}/knowledge_bases/{knowledge_base_name} This API endpoint lists details about a knowledge base 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.
knowledge_base_name
string
required
Defines the knowledge base name to get its details.

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.
curl -X GET http://127.0.0.1:47334/api/projects/mindsdb/knowledge_bases/my_kb
{
  "id": 2,
  "name": "my_kb",
  "project_id": 1,
  "vector_database": "my_kb_chromadb",
  "vector_database_table": "default_collection",
  "updated_at": "2025-06-26 10:24:06.311655",
  "created_at": "2025-06-26 10:24:06.311654",
  "query_id": null,
  "embedding_model": {
    "provider": "openai",
    "model_name": "text-embedding-3-small",
    "api_key": "******"
  },
  "reranking_model": {
    "provider": "openai",
    "model_name": "gpt-4o",
    "api_key": "******"
  },
  "metadata_columns": [
    "product"
  ],
  "content_columns": [
    "notes"
  ],
  "id_column": "order_id",
  "params": {
    "created_embedding_model": "kb_embedding_my_kb"
  }
}