v50

latestSwagger 2.0raw.githubusercontent.com2026-08-07307239824.1 KB
知识管理

更新知识

更新知识条目信息

put/knowledge/{id}

Path parameters

idstring required

知识ID

Request body

channelstring

Channel indicates through which channel the knowledge was ingested (web, api, browser_extension, wechat, etc.)

created_atstring

Creation time of the knowledge

custom_metadatainteger[]

CustomMetadata is user-authored descriptive metadata. It is deliberately separate from Metadata, which contains internal ingestion state and IDs.

descriptionstring

Description of the knowledge

embedding_model_idstring

ID of the embedding model

enable_statusstring

Enable status of the knowledge

error_messagestring

Error message of the knowledge

file_hashstring

File hash of the knowledge

file_namestring

File name of the knowledge

file_pathstring

File path of the knowledge

file_sizeinteger

File size of the knowledge

file_typestring

File type of the knowledge

folder_pathstring

FolderPath is the canonical relative directory this entry belongs to inside the knowledge base, e.g. "docs/spec" for a folder upload of "docs/spec/design.md". Empty means the knowledge base root. It is a display/navigation concern only: it never affects where the file is physically stored (see FilePath).

idstring

Unique identifier of the knowledge

knowledge_base_idstring

ID of the knowledge base

knowledge_base_namestring

Knowledge base name (not stored in database, populated on query)

last_faq_import_resultinteger[]

Last FAQ import result (for FAQ type knowledge only)

metadatainteger[]

Metadata of the knowledge

parse_statusstring

Parse status of the knowledge

pending_subtasks_countinteger

PendingSubtasksCount is the outstanding enrichment subtask count (summary + question + graph chunks). Only meaningful while ParseStatus == "finalizing"; defaults to 0 in any terminal state.

processed_atstring

Processed time of the knowledge

sourcestring

Source of the knowledge (e.g. URL address for url type, "manual" for manual type)

storage_sizeinteger

Storage size of the knowledge

summary_statusstring

Summary status for async summary generation

tenant_idinteger

Workspace ID

titlestring

Title of the knowledge

typestring

Type of the knowledge

updated_atstring

Last updated time of the knowledge

Response

更新成功

object required