Skip to main content
POST
create knowledge group

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Name and optional description for the new knowledge group. The group starts empty — upload documents separately via POST /v1/knowledge/groups/{id}/documents.

name
string
required
description
string
chunkSize
integer | null

Default maximum tokens per chunk for documents processed in this group. When not set or null, the group stores the default of 350.

Required range: 100 <= x <= 2000
chunkOverlap
integer | null

Default token overlap for documents processed in this group. Must be at most half of chunkSize, or at most 175 when chunkSize is not set. When not set or null, the group stores the default of 0.

Required range: 0 <= x <= 1000

Response

Successfully created knowledge group

A folder of documents that a persona can search via RAG tools.

id
string<uuid>

Unique identifier for the knowledge group.

name
string

Human-readable name for the group.

description
string | null

Free-form description of what the group contains.

documentCount
integer

Number of non-deleted documents currently in the group.

chunkSize
integer | null

Default maximum tokens per chunk for documents in this group. Null means documents use the default of 350.

chunkOverlap
integer | null

Default token overlap for documents in this group. Null means documents use the default of 0.

createdAt
string<date-time>

Timestamp when the group was created.

updatedAt
string<date-time> | null

Timestamp when the group was last updated.