Skip to main content
POST
Create a knowledge base

Authorizations

Authorization
string
header
required

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

Body

application/json

The knowledge base to create.

accountId
string
required

Account the knowledge base belongs to, e.g. 7. Not an account on its own: accountId is only unique within an instance, so always send instance with it — the pair is what names the account. The account must be provisioned to your tenants — the reach an unfiltered listMyKnowledgeBases shows — not merely a CloudChat membership: an account outside that reach is refused with 403 and nothing is created.

instance
string
required

CloudChat instance the account lives in, e.g. 4. Together with accountId it names exactly one account, which accountId alone does not. Take the pair from a listMyKnowledgeBases row, or from listMyCloudChatAccounts for an account that holds no knowledge base yet.

name
string
required

Display name, as shown in the knowledge base list. Must not be blank.

Example:

"Support FAQ"

Response

The knowledge base as created. Its id is what every content endpoint takes.

A knowledge base you can manage.

name
string
required

Display name.

Example:

"Support FAQ"

accountId
string
required

Account this knowledge base belongs to, e.g. 7. Only unique within instance: read the two together — the pair is what identifies the account, and accountId on its own does not.

instance
string
required

CloudChat instance the account lives in, e.g. 4. With accountId it forms the pair that identifies this row's account, which is what tells rows apart when one listing spans several accounts.

createdAt
string
required

When it was created (ISO-8601).

Example:

"2026-08-10T14:32:05"

updatedAt
string
required

When it last changed (ISO-8601).

Example:

"2026-08-10T18:20:41"

id
string

Use this id in the content endpoints.

Example:

"6683f1c2a4b19e0012ab34cd"