OpenAPI 3.1.0raw.githubusercontent.com2026-08-202766453.1 MB

2cd7e7f7bcb4

Knowledge Bases

Create a new datasource

Creates a datasource shell when only a display name is provided. When file_id is provided, the uploaded file is queued for chunking and ingestion.

post/v2/knowledge/{knowledge_id}/datasources

Path parameters

knowledge_idstring required

Request body

display_namestring
descriptionstring nullable

The description of the knowledge base

file_idstring
idstring

Compatibility fields used by the former datasource shell/legacy route.

Response

Datasource successfully created

display_namestring required
descriptionstring nullable

The description of the knowledge base

status'pending' | 'processing' | 'completed' | 'failed' | 'queued' required
file_idstring nullable

The unique identifier of the file used to create the datasource.

createdstring required
updatedstring required
created_by_idstring uuid nullable

The user ID of the creator of the knowledge base

update_by_idstring uuid nullable

The user ID of the last user who updated the knowledge base

knowledge_idstring required
chunks_countnumber double required
_idstring required