Knowledge Base

Update a document's raw text

Partially updates a raw-text document — supply any of title, summary, text (at least one) — and re-ingests it. Supply tag_ids alongside them to replace the document's tags in the same call.

patch/org/kb/nodes/{id}/raw

Request

Base URL
https://apiv2.senso.ai/api/v1
Auth
API key in header X-API-Key

Path parameters

idstring uuid required

The document node's kb_node_id.

Request body

titlestring

summarystring

textstring

tag_idsstring[]

Replaces the document's full tag set. Omit to leave the existing tags unchanged; send an empty array to remove them all. Each id must be a tag that already exists in your organization — an unknown id is rejected and no part of the update is applied. To attach tags by name, use the node-tags endpoints.

Response

The updated document.

idstring uuid required

org_idstring uuid required

type'raw' | 'web' | 'file' required

The content's source kind.

titlestring

summarystring

latest_content_version_idstring uuid

version_numinteger

processing_status'pending' | 'processing' | 'complete' | 'failed'

The ingestion status of the content.

error_codestring

Stable classification of an ingestion failure; present only when processing_status is failed.

content_typestring required

The MIME type of the content (e.g. text/markdown, application/pdf).

kb_node_idstring uuid

The node addressing this content in the KB tree. Absent for content with no node (e.g. content-engine drafts).

created_atstring date-time required

updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.