v6

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-0182128753.1 KB
Knowledge Bases

Get Knowledge Base

Returns detailed information about a knowledge base, including its embedding model, retrieval configuration, and document statistics.

get/datasets/{dataset_id}

Path parameters

dataset_idstring uuid required

Knowledge base ID, from List Knowledge Bases.

Response

Knowledge base details.

idstring

Unique identifier of the knowledge base.

namestring

Display name of the knowledge base. Unique within the workspace.

descriptionstring

Optional text describing the purpose or contents of the knowledge base.

providerstring

Provider type. vendor for internally managed, external for external knowledge base connections.

permissionstring

Controls who can access this knowledge base. Possible values: only_me, all_team_members, partial_members.

data_source_typestring

Data source type of the documents, null if not yet configured.

indexing_techniquestring

high_quality uses embedding models for precise search; economy uses keyword-based indexing.

app_countinteger

Number of applications currently using this knowledge base.

document_countinteger

Total number of documents in the knowledge base.

word_countinteger

Total word count across all documents.

created_bystring

ID of the user who created the knowledge base.

author_namestring

Display name of the creator.

created_atnumber

Creation timestamp (Unix epoch in seconds).

updated_bystring

ID of the user who last updated the knowledge base.

updated_atnumber

Last update timestamp (Unix epoch in seconds).

embedding_modelstring

Name of the embedding model used for indexing.

embedding_model_providerstring

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).

embedding_availableboolean

Whether the configured embedding model is currently available.

doc_formstring

Document chunking mode. text_model for standard text chunking, hierarchical_model for parent-child structure, qa_model for QA pair extraction.

built_in_field_enabledboolean

Whether built-in metadata fields (e.g., document_name, uploader) are enabled.

pipeline_idstring nullable

Pipeline ID, if a custom processing pipeline is configured.

runtime_modestring nullable

Runtime processing mode.

chunk_structurestring nullable

Chunk structure configuration.

is_publishedboolean

Whether the knowledge base is published.

total_documentsinteger

Total number of documents.

total_available_documentsinteger

Number of documents that are enabled and available.

enable_apiboolean

Whether API access is enabled for this knowledge base.

is_multimodalboolean

Whether multimodal content processing is enabled.

maintainerstring nullable

Display name of the knowledge base maintainer. null if not set.

partial_member_liststring[] nullable

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.