CreateKnowledgeNoteInput
Contribute a knowledge note about a concept or a specific entity. The attachment is immutable once created.
Fields
Selects the target: CONCEPT requires conceptId; ENTITY requires entityId.
Possible values (2)
CONCEPTThe note is about a concept in the ontology (conceptId is set).
ENTITYThe note is about a specific entity (entityType + entityId are set).
Concept to attach to, required when kind is CONCEPT.
The entity to attach to, required when kind is ENTITY — a TypeID (e.g. "wcr_01K…") whose prefix names the entity kind.
The note's free-text content.
Initial visibility; defaults to PERSONAL.
Possible values (2)
PERSONALVisible to and weighted up for its author only.
TENANTShared knowledge, visible to the whole tenant.
Initial review status; defaults to LIVE. Pass PENDING to contribute a proposed note awaiting confirmation.
Possible values (2)
PENDINGProposed (e.g. distilled by an agent) and awaiting human confirmation; excluded from retrieval until confirmed.
LIVEConfirmed and active; visible per scope and surfaced by retrieval.
How the note originated; defaults to MANUAL.
Possible values (3)
MANUALA person wrote the note directly.
CHAT_DISTILLEDDistilled by AI from a chat/assistant conversation.
JOURNEY_CAPTUREDCaptured automatically while a user carried out a journey/workflow.
Referenced by (1)
Exact type SDL
"""
Contribute a knowledge note about a concept or a specific entity. The attachment is immutable once created.
"""
input CreateKnowledgeNoteInput {
"""
Selects the target: CONCEPT requires `conceptId`; ENTITY requires `entityId`.
"""
kind: KnowledgeAttachmentKind!
"""Concept to attach to, required when `kind` is CONCEPT."""
conceptId: ConceptID
"""
The entity to attach to, required when `kind` is ENTITY — a TypeID (e.g. "wcr_01K…") whose prefix names the entity kind.
"""
entityId: ID
"""The note's free-text content."""
body: String!
"""Initial visibility; defaults to PERSONAL."""
scope: KnowledgeScope
"""
Initial review status; defaults to LIVE. Pass PENDING to contribute a proposed note awaiting confirmation.
"""
status: KnowledgeStatus
"""How the note originated; defaults to MANUAL."""
provenance: KnowledgeProvenance
}