Does updating a document append or replace?

Updating a document with new text replaces the whole body. It does not append. Read the current text first and send the complete new version, never a fragment.

Each update cuts a new revision, so the previous text stays readable at its own version number. Nothing is lost, but the live body is whatever you last sent.

bash

# PUT replaces the body outright — anything not sent is gone.
curl -X PUT https://apiv2.senso.ai/api/v1/org/kb/nodes/$NODE_ID/raw \
  -H "X-API-Key: $SENSO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "# Refund policy\n\nRefunds are issued within 14 days..."}'

Call it

PUT/org/kb/nodes/{id}/rawOpen in API reference →Replace the body outright.

PATCH/org/kb/nodes/{id}/rawOpen in API reference →Change part of it.