Sign in
latestOpenAPI 3.0.32026-08-227451,2751.8 MB

d0fc0114da66

KnowledgeGraph

Update a knowledge graph node

Updates an existing knowledge graph node. Mandatory If-Match header for optimistic locking. Re-embeds atomically when name, summary, or content changes. On Vertex 5xx, returns 503 with Retry-After.

patch/knowledgeGraph/nodes/{node_id}

Path parameters

node_idstring required

The ID of the node to update

Query parameters

workspace_idstring required

The workspace ID (required for auth scope)

application_idstring

The application ID (required for auth scope)

Headers

If-Matchstring

ETag for optimistic locking. Functionally required: omitting it surfaces a typed 428 (Precondition Required) response with code "etag_required" so an agent can recover deterministically. Declared as required=false at the schema level so the request reaches the service rather than being rejected by the OpenAPI validator with a generic 400.

Request body

namestring

Updated name (preserves existing value if absent or null; triggers re-embedding when changed)

summarystring

Updated summary (preserves existing value if absent or null; triggers re-embedding when changed)

contentstring

Updated content (preserves existing value if absent or null; triggers re-embedding when changed; max 20K chars before fallback)

status'ACTIVE' | 'ARCHIVED'

Status of a knowledge graph node

confidencenumber double

Updated confidence score (preserves existing value if absent or null)

provenance_summarystring

Updated provenance summary (preserves existing value if absent or null)

propertiesobject

Updated additional structured properties (preserves existing value if absent or null)

agent_typestring

Agent type performing the update (preserves existing value if absent or null)

agent_versionstring

Agent version performing the update (preserves existing value if absent or null)

Response

The updated 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