---
schema_version: "1"
id: 30cbeaa1e5081fa2717e266e1a98898cbd937073067e2c26fcb75db1efc70ee7
title: Tableau Knowledge Graph Methods
collection: tableau
version: current
locale: en-us
portal_url: https://docs.salesforce.com/tableau/current/en-us/api/rest_api/REST/rest_api_ref_tableau_knowledge_graph.md
canonical_url: https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_tableau_knowledge_graph.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 88fef882e1ac2280d534277a3bef509818ba6ec6ad58b496c8007affafff54fa
description: Read and write the per-site Tableau Knowledge Graph
---
[Skip to main content](#main-content)

# 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Creator role. The user can read/write nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:write\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

POST {server}/api/v1/knowledge/semantic-contexts

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Creator role. The user can read/write nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:write\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

DELETE {server}/api/v1/knowledge/semantic-contexts/{ctx\_id}

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Any authenticated user. The user can read nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:read\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

GET {server}/api/v1/knowledge/nodes/{node\_id}/lineage

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Any authenticated user. The user can read nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:read\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

GET {server}/api/v1/knowledge/nodes/{node\_id}

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Any authenticated user. The user can read nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:read\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

GET {server}/api/v1/knowledge/nodes/{node\_id}/impact

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Any authenticated user. The user can read nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:read\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

GET {server}/api/v1/knowledge/graphs

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Any authenticated user. The user can read nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:read\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

POST {server}/api/v1/knowledge/edges/search

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Any authenticated user. The user can read nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:read\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

POST {server}/api/v1/knowledge/nodes/search

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Any authenticated user. The user can read nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:read\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

POST {server}/api/v1/knowledge/nodes/{node\_id}/semantic-contexts/search

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Any authenticated user. The user can read nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:read\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

POST {server}/api/v1/knowledge/semantic-contexts/search

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Any authenticated user. The user can read nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:read\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

POST {server}/api/v1/knowledge/sources/search

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Any authenticated user. The user can read nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:read\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

POST {server}/api/v1/knowledge/suggestions/search

[view details](#)

## 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](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)

**Permissions:** Creator role. The user can read/write nodes allowed by content permissions.  
[Permissions Overview](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_permissions.htm)

**License:** Tableau Cloud+

**Access Scope:** \`tableau:knowledge:write\`  
[Tableau Cloud](https://help.tableau.com/current/online/en-us/connected_apps_scopes.htm) | [Tableau Server-Windows](https://help.tableau.com/current/server/en-us/connected_apps_scopes.htm) | [Tableau Server-Linux](https://help.tableau.com/current/server-linux/en-us/connected_apps_scopes.htm)

PATCH {server}/api/v1/knowledge/semantic-contexts/{ctx\_id}

[view details](#)