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"
  }
}