Skip to main content
POST
/
v1
/
kb
/
nodes
Create knowledge node
curl --request POST \
  --url https://api.conduit.ai/v1/kb/nodes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Checkout instructions",
  "body": "Checkout is at 11 AM...",
  "entity_ids": [
    "ent_abc"
  ],
  "enabled": true
}
'
{
  "data": {
    "id": "<string>",
    "workspace_id": "<string>",
    "title": "<string>",
    "body": "<string>",
    "chunk_body": true,
    "entity_ids": [
      "<string>"
    ],
    "parent_id": "<string>",
    "ancestors": [
      "<string>"
    ],
    "depth": 123,
    "source": "pms",
    "source_type": "pdf",
    "source_id": "<string>",
    "is_directory": true,
    "metadata": {},
    "enabled": true,
    "created_by": "<string>",
    "embed_status": "<string>",
    "chunk_count": 123,
    "version": 123,
    "tags": [
      "<string>"
    ],
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.

Query Parameters

workspace_id
string
required

Workspace to query.

Example:

"j57demo8f8x7c9v0n2q4r6t8y1u3i5o"

Body

application/json
title
string
required

Node display title.

Minimum string length: 1
body
string

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

parent_id
string

Parent node id. Omit to create at workspace root.

entity_ids
string[]

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

is_directory
boolean

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

metadata
object

Arbitrary JSON metadata. Not searchable.

enabled
boolean

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

Response

Knowledge node created

data
object
required