create knowledge group

curl --request POST \ --url https://api.anam.ai/v1/knowledge/groups \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "Product docs", "description": "Help-centre articles and API reference." } '

{ "id": "00000000-0000-0000-0000-000000000000", "name": "Product docs", "description": "Help-centre articles and API reference.", "documentCount": 12, "createdAt": "2026-04-20T10:00:00.000Z", "updatedAt": "2026-04-20T10:00:00.000Z" }

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

Response

Successfully created knowledge group

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

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.

createdAt

string<date-time>

Timestamp when the group was created.

updatedAt

string<date-time> | null

Timestamp when the group was last updated.