← All types
AI & MLIn Input object

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)
CONCEPT

The note is about a concept in the ontology (conceptId is set).

ENTITY

The note is about a specific entity (entityType + entityId are set).

Concept to attach to, required when kind is CONCEPT.

entityId

IDOptional

The entity to attach to, required when kind is ENTITY — a TypeID (e.g. "wcr_01K…") whose prefix names the entity kind.

body

String!Required

The note's free-text content.

Initial visibility; defaults to PERSONAL.

Possible values (2)
PERSONAL

Visible to and weighted up for its author only.

TENANT

Shared knowledge, visible to the whole tenant.

Initial review status; defaults to LIVE. Pass PENDING to contribute a proposed note awaiting confirmation.

Possible values (2)
PENDING

Proposed (e.g. distilled by an agent) and awaiting human confirmation; excluded from retrieval until confirmed.

LIVE

Confirmed and active; visible per scope and surfaced by retrieval.

How the note originated; defaults to MANUAL.

Possible values (3)
MANUAL

A person wrote the note directly.

CHAT_DISTILLED

Distilled by AI from a chat/assistant conversation.

JOURNEY_CAPTURED

Captured 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
}