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 business preference
Create a business preference that applies to the whole graph and carries 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 business preference
Delete a business preference 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 business preferences 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 business preferences for a node
Search the business preferences that apply to the given 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 business preferences
Search business preferences 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 business preference
Partially update a business preference.
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}