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:
Id fields in Salesforce, and in Tableau Next, are typically 15-character, base-62, case-sensitive strings. This is true of JSON XMD too. 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:
/tableau/workspaces/{workspaceIdOrApiName}/assets/{assetId}.
The last 3 digits are a checksum of the preceding 15 characters. The use of case-insensitive Id’s eases interaction with external applications and development environments that use case-insensitive references. To convert an 18-character Id back to a 15-character ID, simply remove the last 3 characters.
| Resource | Description | Supported HTTP Methods | Resource URL |
|---|---|---|---|
| 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 |
| Removed 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 workspaces. | 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 |