v1

latestOpenAPI 3.1.02026-08-047777149.4 KB

Knowledge Base

Update a note

Partial update — omitted fields are left unchanged. Externally-synced notes (sourceKind != manual) are read-only and return 409.

patch/api/v4/workspaces/{workspace}/notes/{noteId}

Path parameters

workspacestring required

Workspace short name

noteIdstring uuid required

Note identifier (UUID)

Request body

titlestring nullable

contentstring

resourcePathsstring[]

abstractEntitiesstring[]

tagsstring[]

status'active' | 'deprecated'

verifiedboolean

Response

Updated note

noteIdstring uuid

Unique note identifier

titlestring nullable

Short note title

contentstring

Note content (max 20000 chars)

resourcePathsstring[]

Authored explicit resource paths

lastResolvedAtstring date-time nullable

resolutionStatestring nullable

ok | pending | error

indexingStatestring nullable

USearch index state (completed | failed | queued | ...)

abstractEntitiesstring[]

tagsstring[]

Author-facing labels

statusstring

Note lifecycle status (active | deprecated)

verifiedboolean

Whether note is human-verified

authorEmailstring nullable

createdAtstring date-time

updatedAtstring date-time

sourceKindstring

Origin: "manual" or external (e.g. "git")

sourcestring nullable

Origin/collection (e.g. repo URL)

sourceIdstring nullable

Identifier within the source (e.g. file path)

sourceRefstring nullable

Version pointer at last sync (e.g. commit)

readOnlyboolean

True for externally-synced notes (edit at source)