Create Assistant Knowledge

Authorization

access-token

X-Access-Token<token>

Enter your Access Token (format: happ_...)

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Knowledge item name

type*string

Type of knowledge base content

Value in

"url"
"text"
"file"

resourceUrl?string

Resource URL (required when type is url)

resourceDescription?string

Short summary of the resource shown to the LLM when selecting knowledge

resourceContent?string

Inline text content of the knowledge item (used when type is text)

assistantId*string

ID of the assistant the knowledge item belongs to

Formatuuid

fileId?string

File ID to associate with knowledge base

vectorIds?array<string>

Array of vector IDs for knowledge base

isVector*boolean

Whether this knowledge is vector-based

Defaultfalse

chunkingStrategy*string

How the content is split into chunks for vector indexing

Default"tokens"

Value in

"tokens"
"items"

itemDelimiter?string

Delimiter string that separates items when chunking by delimiter

isSystem*boolean

Whether this is a system-managed knowledge base

Defaultfalse

Response Body

curl -X POST "https://example.com/api/assistant-knowledge" \  -H "Content-Type: application/json" \  -d '{    "name": "Product FAQ",    "type": "url",    "assistantId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",    "isVector": false,    "chunkingStrategy": "tokens",    "isSystem": false  }'

Empty

Create Assistant Knowledge

Authorization

Request Body

Response Body

201