v1

latestOpenAPI 3.0.02026-07-26870415.2 KB

Create knowledge node

Creates a manual knowledge node or directory. Requires a token with read_write access. Nodes created through this endpoint are always recorded with source: manual.

post/v1/kb/nodes

Query parameters

workspace_idstring required

Workspace to query.

Example:j57demo8f8x7c9v0n2q4r6t8y1u3i5o

Request body

titlestring required

Node display title.

bodystring

Markdown or plain-text body. Ignored when is_directory is true.

parent_idstring

Parent node id. Omit to create at workspace root.

entity_idsstring[]

Scope the node to specific entities (listings, properties). Omit for workspace-wide.

is_directoryboolean

Create as a folder with no body. Children can be nested underneath.

metadataobject

Arbitrary JSON metadata. Not searchable.

enabledboolean

Defaults to true. Disabled nodes are excluded from agent search.

Example request

{
  "title": "Checkout instructions",
  "body": "Checkout is at 11 AM...",
  "entity_ids": [
    "ent_abc"
  ],
  "enabled": true
}

Response

Knowledge node created