Skip to main content
POST
Create knowledge node

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 file to one entity (a listing, group:<id>, or unit:<listingId>:<subunitId>). Omit for workspace-wide. Files only: folders are structure and carry no scope.

is_directory
boolean

Create as a folder with no body. Children can be nested underneath. Folders carry no scope, so entity_ids must be omitted.

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