Add a Dataset or Domain source to a knowledge base

POST 
/ai/knowledgebases/:id/resources

Attaches one Dataset or Domain source. Requires editor access on the knowledge base and on the dataset or domain. Unstructured knowledge bases allow at most 5 sources and accept optional ChunkingConfiguration (default NONE) and ParsingConfiguration (default DEFAULT). Structured knowledge bases ignore chunking/parsing; the dataset TargetLocation must match the knowledge base DataStoreType. Datasets must be internal (not Hudi or Iceberg).

Request

Responses

200

Source added. Unstructured responses include SourceId; structured responses include KnowledgebaseId. Message names the attached resource.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Input validation or authorization failure. Body is {"Message": " - "}. Codes: IPV-1008 (invalid ResourceType/ResourceKey), IPV-1002 (KB or dataset not found), IPV-1061 (unsupported ResourceType or dataset), GE-1096 (maximum 5 sources), GE-1009 (duplicate source), AUTH-1001 (missing role_id), AUTH-1012 (editor required), AUTH-1011 (caller not authorized).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}. Codes: GE-1085 (unexpected backend failure), DB-1002 (persistence failure).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers