Get Knowledge Base
Returns detailed information about a knowledge base, including its embedding model, retrieval configuration, and document statistics.
Authorizations
Every request authenticates with an API key: Authorization: Bearer {API_KEY}. App endpoints take an app API key; knowledge endpoints take a knowledge base API key (Get Started).
Keep keys server-side; never embed them in client code. Requests with a missing or invalid key fail with HTTP 401 (unauthorized).
Path Parameters
Knowledge base ID, from List Knowledge Bases.
Response
Knowledge base details.
Unique identifier of the knowledge base.
Display name of the knowledge base. Unique within the workspace.
Optional text describing the purpose or contents of the knowledge base.
Provider type. vendor for internally managed, external for external knowledge base connections.
Controls who can access this knowledge base. Possible values: only_me, all_team_members, partial_members.
Data source type of the documents, null if not yet configured.
high_quality uses embedding models for precise search; economy uses keyword-based indexing.
Number of applications currently using this knowledge base.
Total number of documents in the knowledge base.
Total word count across all documents.
ID of the user who created the knowledge base.
Display name of the creator.
Creation timestamp (Unix epoch in seconds).
ID of the user who last updated the knowledge base.
Last update timestamp (Unix epoch in seconds).
Name of the embedding model used for indexing.
Embedding model provider identifier, formatted as organization/plugin_name/provider_name (e.g. langgenius/openai/openai). Legacy knowledge bases may return the bare short form (e.g. openai).
Whether the configured embedding model is currently available.
Retrieval configuration for the knowledge base.
Summary index configuration.
Tags associated with this knowledge base.
Document chunking mode. text_model for standard text chunking, hierarchical_model for parent-child structure, qa_model for QA pair extraction.
Connection details for external knowledge bases. Present when provider is external.
Retrieval settings for external knowledge bases. null for internal knowledge bases.
Metadata field definitions for the knowledge base.
Whether built-in metadata fields (e.g., document_name, uploader) are enabled.
Pipeline ID, if a custom processing pipeline is configured.
Runtime processing mode.
Chunk structure configuration.
Icon display configuration for the knowledge base.
Whether the knowledge base is published.
Total number of documents.
Number of documents that are enabled and available.
Whether API access is enabled for this knowledge base.
Whether multimodal content processing is enabled.
Display name of the knowledge base maintainer. null if not set.
Account IDs of members granted access when permission is partial_members. Always present on the update response; on the detail response, present only when permission is partial_members.