KnowledgeGraph

Create a knowledge graph node

Creates a new node in the knowledge graph for a workspace. Server generates the node_id with suffix -kgn.

post/knowledgeGraph/nodes

Request

  • Base URL: https://api.mabl.com
  • URL: https://api.mabl.com/knowledgeGraph/nodes
  • Auth: one of:
    • HTTP basic
    • API key in header Authorization

Request body

workspace_idstring required

The workspace to create the node in

application_idstring

The application this node is associated with

label'Page' | 'Workflow' | 'Feature' | 'KnowledgeDoc' | 'Pattern' required

Label for a knowledge graph node indicating its concept type

namestring required

The name of the concept

summarystring

A short summary of the concept

contentstring

Detailed content for this node (max 20K chars before embedding fallback)

confidencenumber double

Confidence score (0.0-1.0)

provenance_summarystring

Free-text provenance summary

propertiesobject

Additional structured properties

agent_typestring

Agent type creating this node

agent_versionstring

Agent version creating this node

Response

The created node

node_idstring

Unique identifier for the node (server-generated, suffix -kgn)

workspace_idstring

The workspace this node belongs to

application_idstring

The application this node is associated with

label'Page' | 'Workflow' | 'Feature' | 'KnowledgeDoc' | 'Pattern'

Label for a knowledge graph node indicating its concept type

namestring

The name of the concept

summarystring

A short summary of the concept

contentstring

Detailed content for this node (max 20K chars before embedding fallback)

status'ACTIVE' | 'ARCHIVED'

Status of a knowledge graph node

confidencenumber double

Confidence score (0.0-1.0) mapped from tier (high=1.0, medium=0.6, low=0.3)

provenance_summarystring

Free-text provenance summary for this concept

propertiesobject

Additional structured properties for this node

embedding_input_is_summaryboolean

True if embedding was computed from summary rather than content (content exceeded 20K chars)

versioninteger

Monotonic edit counter (server-managed, readOnly)

u_version_string

ETag for optimistic locking (server-managed, readOnly)

last_updated_bystring

Principal who last updated this node (server-managed, readOnly)

agent_typestring

Agent type that wrote this node (e.g. AMA-Bootstrap, RAA-Enrichment)

agent_versionstring

Agent version that wrote this node

created_bystring

Principal who created this node (server-managed, readOnly)

created_atstring date-time

Creation timestamp

updated_atstring date-time

Last update timestamp

Changes

No recorded changes to this operation across all 37 revisions of this API.