Tableau Next Connect REST API Resources Overview
The Tableau Next Connect REST API provides resources to access your Tableau Next assets and more.
All Tableau Next Connect REST API resources are accessed using:
- A base URL for your Salesforce org (
https://<your_instance_name>) - The Connect API version information (
/services/data/v64.0) - The Tableau Next resource (
/tableau/visualizations)
Put together, a full URL is:
1https://<your_instance_name>/services/data/v64.0/tableau/visualizations</your_instance_name>Org and Object Identifiers
ID fields in Salesforce, and in Tableau Next, are typically 15-character, base-62, case-sensitive strings. This is also true of JSON XMD. However, many Salesforce APIs, including the Tableau Next Connect REST API, use 18-character, case-insensitive strings. For example, the id property of the asset resource appears in a path like the following:
1/tableau/workspaces/{workspaceIdOrApiName}/assets/{assetId}The last 3 characters are a checksum of the preceding 15 characters. Case-insensitive IDs ease interaction with external applications and development environments that use case-insensitive references. To convert an 18-character ID back to a 15-character ID, remove the last 3 characters.
Tableau Next Resources
| Resource | Description | Supported HTTP Methods | Resource URL |
|---|---|---|---|
| Dashboards | Returns a collection of dashboards or creates a new dashboard. | GET, POST | /tableau/dashboards |
| Returns, updates, or deletes a dashboard with the specified ID or API name. | GET, PATCH, DELETE | /tableau/dashboards/{dashboardIdOrApiName} | |
| Returns the bundle for a dashboard with the specified ID or API name. | GET | /tableau/dashboards/{dashboardIdOrApiName}/bundle | |
| Returns a collection of custom views for a dashboard or creates a new custom view. | GET, POST | /tableau/dashboards/{dashboardIdOrApiName}/customviews | |
| Returns the default custom view for a dashboard. | GET | /tableau/dashboards/{dashboardIdOrApiName}/customviews/default | |
| Returns the specified custom view, or deletes a custom view. | GET, POST | /tableau/dashboards/{dashboardIdOrApiName}/customviews/{viewId} | |
| Returns a dashboard from the specified template. | GET | /tableau/templates/{templateSourceId}/dashboards/{dashboardTemplateName} | |
| Downloads | Download an asset image | POST | /tableau/download |
| Followers | Returns a collection of followers for a specific followed asset | GET | /tableau/follow/assets/{followedAssetId}/followers |
| Returns a collection of followed assets for a user | GET | /tableau/follow/followers/{followerId}/followed-assets | |
| Add a user as a follower of a specified asset or a collection of assets | POST, PATCH | /tableau/follow/followers/{followerId}/follows | |
| Unfollow a specified asset for a specified user | DELETE | /tableau/follow/followers/{followerId}/follows/{followedAssetId} | |
| Get a unique follower count for a specified asset | GET | /tableau/follow/assets/{followedAssetId}/follower-count | |
| Record Access Shares | Get a collection of shares for a specified record for the requesting grantee user, or share, update, or delete access to a specified record | GET, POST, PATCH, DELETE | /tableau/records/{recordId}/shares |
| Remove access to a specified record for a specified user | DELETE | /tableau/records/{recordId}/shares/{userOrGroupId} | |
| Subscriptions | Get or update a user’s subscription digest configuration | GET, PATCH | /tableau/subscriptions/digest/{digestConfigOwner} |
| Visualizations | Returns a collection of visualizations or creates a new visualization. | GET, POST | /tableau/visualizations |
| Returns, updates, or deletes a visualization with the specified ID or API name. | GET, PATCH, DELETE | /tableau/visualizations/{visualizationIdOrApiName} | |
| Workspaces | Returns a collection of workspaces or creates a new workspace. | GET, POST | /tableau/workspaces |
| Returns, updates, or deletes a workspace with the specified ID or API name. | GET, PATCH, DELETE | /tableau/workspaces/{workspaceIdOrApiName} | |
| Returns a collection of assets in a workspace or adds an asset to a workspace. | GET, POST | /tableau/workspaces/{workspaceIdOrApiName}/assets |
j