Sign in
latestOpenAPI 3.0.32026-08-227451,2751.8 MB

d0fc0114da66

KnowledgeGraph

Resolve a concept name to a knowledge graph node

Name-based resolution of a concept name to a knowledge graph node: (1) exact lowercased name + label match, (2) substring match via SEARCH_SUBSTRING on name_substring_tokens. Returns null when neither produces a match. The two are NOT equivalent: an exact match is a deterministic identity, while a substring match is a lexical name-overlap SIGNAL (match_kind name_substring) that the caller surfaces to its agent as a candidate to weigh, not an identity verdict. Semantic similarity is not performed here; use the similarityNeighbors endpoint for embedding-based neighborhood lookup. Writer-only endpoint (AMA uses this; not for general-purpose search). concept_type is restricted to Page, Workflow, Feature (AMA's writable concept labels).

post/knowledgeGraph/nodes/resolve

Request body

workspace_idstring required

The workspace ID

application_idstring required

The application ID

concept_type'Page' | 'Workflow' | 'Feature' required

The concept type to resolve against (writer-only labels only)

candidate_namestring required

The candidate name to resolve

Response

A node matched by exact name+label (a deterministic identity) or by name substring (a lexical name-overlap signal for the caller's agent to weigh).

node_idstring required

The resolved node ID

match_kind'exact' | 'name_substring' required

How the node's name relates to the candidate: exact (case-insensitive name equality — a deterministic identity) or name_substring (the candidate name is a substring of the node's name — a lexical overlap signal, not an identity verdict).

confidencenumber double required

Fixed per match_kind (exact = 1.0, name_substring = 0.95). Retained for backward compatibility; it carries no information beyond match_kind and callers should key on match_kind instead.