Sign in

v1

latestOpenAPI 3.0.02026-07-26870415.2 KB
kb

Update knowledge node

Partial update of a knowledge node. Requires a token with read_write access.

patch/v1/kb/nodes/{node_id}

Path parameters

node_idstring required

Knowledge node id (24 hex characters).

Example:65f1a2b3c4d5e6f7a8b9c0d1

Query parameters

workspace_idstring required

Workspace to query.

Example:j57demo8f8x7c9v0n2q4r6t8y1u3i5o

Request body

titlestring

New display title.

bodystring

New markdown or plain-text body. Triggers re-indexing.

parent_idstring nullable

Set to null to move the node to the workspace root. Omit to leave the parent unchanged.

entity_idsstring[]

Replaces the full entity scope. Pass [] to make the node workspace-wide.

metadataobject

Replaces the full metadata object. Pass {} to clear.

enabledboolean

Toggle agent visibility. Disabled nodes are excluded from search.

tagsstring[]

Replaces the full tag set. Pass [] to clear.

Example request

{
  "title": "Checkout instructions (updated)",
  "tags": [
    "seasonal"
  ],
  "enabled": true
}

Response

Knowledge node updated