Tableau Knowledge Graph Methods
Read and write the per-site Tableau Knowledge Graph.
Graph node visibility depends on content permissions. Users can see nodes that they have read access to, and can change nodes that they have write access to.
Note: Knowledge Graph API operations use a v1 path segment (/api/v1/knowledge) in the URI, independent of other Tableau REST API versioning schemes. Always use v1.
Create a semantic context
Create a semantic context node carrying one or more statements.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Creator role. The user can read/write nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:write`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
POST {server}/api/v1/knowledge/semantic-contexts
Delete a semantic context
Delete a semantic context created and managed in Tableau Knowledge, along with its statements.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Creator role. The user can read/write nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:write`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
DELETE {server}/api/v1/knowledge/semantic-contexts/{ctx_id}
Get the lineage of a node
Get the lineage neighborhood of a node.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Any authenticated user. The user can read nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:read`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
GET {server}/api/v1/knowledge/nodes/{node_id}/lineage
Get a node by ID
Get a single node by its ID, including its semantic statements and directly connected nodes.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Any authenticated user. The user can read nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:read`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
GET {server}/api/v1/knowledge/nodes/{node_id}
Get the downstream impact of a node
Get the assets that depend on a node, to see the impact if it changes.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Any authenticated user. The user can read nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:read`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
GET {server}/api/v1/knowledge/nodes/{node_id}/impact
List knowledge graphs
List the knowledge graphs on the caller's Tableau site, each with its ID, name, description, status, and
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Any authenticated user. The user can read nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:read`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
GET {server}/api/v1/knowledge/graphs
List edges around a node
List the edges connected to a node.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Any authenticated user. The user can read nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:read`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
POST {server}/api/v1/knowledge/edges/search
Search graph nodes
Search graph nodes using natural-language semantic search.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Any authenticated user. The user can read nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:read`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
POST {server}/api/v1/knowledge/nodes/search
Search semantic contexts attached to a node
Search the semantic contexts attached to a specific node.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Any authenticated user. The user can read nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:read`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
POST {server}/api/v1/knowledge/nodes/{node_id}/semantic-contexts/search
Search semantic contexts
Search semantic contexts across the graph.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Any authenticated user. The user can read nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:read`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
POST {server}/api/v1/knowledge/semantic-contexts/search
List knowledge sources
List the data sources and workbooks connected to the graph.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Any authenticated user. The user can read nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:read`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
POST {server}/api/v1/knowledge/sources/search
Get graph-health suggestions
Get a report on the health of the graph, including a score and suggested improvements.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Any authenticated user. The user can read nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:read`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
POST {server}/api/v1/knowledge/suggestions/search
Update a semantic context
Partially update a semantic context.
Version: Available in Tableau Cloud September 2026 and later. Not available for Tableau Server. Version Overview
Permissions: Creator role. The user can read/write nodes allowed by content permissions.
Permissions Overview
License: Tableau Cloud+
Access Scope: `tableau:knowledge:write`
Tableau Cloud | Tableau Server-Windows | Tableau Server-Linux
PATCH {server}/api/v1/knowledge/semantic-contexts/{ctx_id}