Sign in

v28

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-05-2887246443.7 KB

Add sources to a knowledge base

post/add-knowledge-base-sources/{knowledge_base_id}

Path parameters

knowledge_base_idstring required
Example:kb_1234567890

The knowledge base id to delete source from.

Response

Successfully created a new knowledge base.

knowledge_base_idstring required

Unique id of the knowledge base.

knowledge_base_namestring required

Name of the knowledge base. Must be less than 40 characters.

status'in_progress' | 'complete' | 'error' | 'refreshing_in_progress' required

Status of the knowledge base. When it's created and being processed, it's "in_progress". When the processing is done, it's "complete". When there's an error in processing, it's "error". When it is during kb updating, it's "refreshing_in_progress".

max_chunk_sizeinteger

Maximum number of characters per chunk when splitting knowledge base content.

min_chunk_sizeinteger

Minimum number of characters per chunk. Chunks smaller than this are merged with adjacent chunks.

enable_auto_refreshboolean

Whether to enable auto refresh for the knowledge base urls. If set to true, will retrieve the data from the specified url every 12 hours.

last_refreshed_timestampinteger

Last refreshed timestamp (milliseconds since epoch). Only applicable when enable_auto_refresh is true.

Example response

{
  "knowledge_base_id": "knowledge_base_a456426614174000",
  "knowledge_base_name": "Sample KB",
  "status": "in_progress",
  "max_chunk_size": 2000,
  "min_chunk_size": 400,
  "enable_auto_refresh": true,
  "last_refreshed_timestamp": 1703413636133
}
All 87 operations