Documentation Index

Fetch the complete documentation index at: https://docs.lansweeper.com/llms.txt

Use this file to discover all available pages before exploring further.

Tableau Connector

Prev Next
Note on third‑party tools

We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation.

Tableau is an interactive data visualization software company focused on business intelligence.
This component allows managing users, projects, workbooks, and connections through the Tableau REST API.

API Documentation

This component was built using the Tableau REST API Documentation.

Connections

Personal Access Token

Authenticate requests to Tableau using a Personal Access Token.

This component uses Personal Access Token authentication to interact with the Tableau REST API.
Create a connection of type Personal Access Token.

Prerequisites

  • A Tableau Cloud or Tableau Server account with permission to create Personal Access Tokens.

Setup Steps

  1. Log in to Tableau.
  2. Click the user icon in the top right, and click My Account Settings.
  3. Under Personal Access Tokens, type in a Token Name and select Create new token.
    Take note of the Token Name and Token Secret. These are entered into the connection in a moment.
  4. Locate the Tableau URL.
    It looks like https://10ay.online.tableau.com/#/site/MarketingTeam/workbooks.
    The 10ay.online.tableau.com portion is the Host Name, and MarketingTeam is the Site ID.

Configure the Connection

  • Token Name: The name of the Personal Access Token created above.
  • Token Secret: The secret value of the Personal Access Token created above.
  • Host Name: The Tableau server host, without the https:// prefix (for example, 10ay.online.tableau.com).
  • Site ID: The Tableau site identifier (for example, MarketingTeam).

For additional information regarding authentication, refer to the Tableau docs.

Input Comments Default
Token Secret The Tableau Personal Access Token secret. This value can be created from the Tableau account.
Token Name The name of the Tableau Personal Access Token.
Host Name The host name of the Tableau server, without the https:// prefix.
Site ID The ID of the Tableau site (the MarketingTeam part of https://10ay.online.tableau.com/#/site/MarketingTeam/workbooks).

Triggers

New and Updated Records

Checks for new and updated records in a selected Tableau resource type on a configured schedule.

Input Comments Default
Connection
Resource Type The Tableau resource collection to poll for new and updated records. workbooks
Show New Records When true, records whose createdAt falls after the last poll are emitted on the created branch. true
Show Updated Records When true, records whose updatedAt falls after the last poll but were created earlier are emitted on the updated branch. true

Webhook Events

Receive event notifications from Tableau. Automatically creates and manages a webhook subscription for the selected events when the instance is deployed, and removes the subscription when the instance is deleted.

Input Comments Default
Connection
API Event Name The events to subscribe to.
API Version The version of the Tableau API to use. 3.6
Timeout The maximum amount of time the client will await a response.

Actions

Create Project

Create a new project in a Tableau site.

Input Comments Default
Parent Project ID The unique identifier for the parent project.
Project Name The display name shown for the project in Tableau.
Content Permissions Controls user permissions in a project. A nested project inherits the parent's permissions and this setting has no effect.
Description A description of the project.
Timeout The maximum amount of time the client will await a response.
Connection

Create User

Create a new user in a Tableau site.

Input Comments Default
Username The username of the user. For Tableau Online, this value is an email address.
Site Role The role assigned to the user on the site.
Auth Setting The authentication method used to sign the user in.
Timeout The maximum amount of time the client will await a response.
Connection

Create Webhook

Create a new webhook for a site.

Input Comments Default
Connection
Webhook Name A descriptive label to identify the webhook in Tableau.
API Event Name The name of the Tableau event that triggers the webhook.
Webhook URL The destination URL for the webhook. The destination URL must use HTTPS and have a valid certificate.
Webhook Enabled When true, the newly created webhook is enabled. When false, the webhook is disabled. true
Timeout The maximum amount of time the client will await a response.
API Version The version of the Tableau API to use. 3.6

Delete Project

Delete an existing project by ID.

Input Comments Default
Project ID The unique identifier for the project.
Timeout The maximum amount of time the client will await a response.
Connection

Delete User

Delete an existing user by ID.

Input Comments Default
User ID The unique identifier for the user.
Timeout The maximum amount of time the client will await a response.
Connection

Delete Webhook

Delete the specified webhook.

Input Comments Default
Connection
Webhook ID The unique identifier for the webhook.
Timeout The maximum amount of time the client will await a response.
API Version The version of the Tableau API to use. 3.6

Delete Workbook

Delete an existing workbook by ID.

Input Comments Default
Workbook ID The unique identifier for the workbook.
Timeout The maximum amount of time the client will await a response.
Connection

Get Project

Retrieve an existing project by ID.

Input Comments Default
Project Name The display name shown for the project in Tableau.
Timeout The maximum amount of time the client will await a response.
Connection

Get User

Retrieve an existing user by ID.

Input Comments Default
User ID The unique identifier for the user.
Timeout The maximum amount of time the client will await a response.
Connection

Get Webhook

Retrieve information about the specified webhook.

Input Comments Default
Connection
Webhook ID The unique identifier for the webhook.
Timeout The maximum amount of time the client will await a response.
API Version The version of the Tableau API to use. 3.6

Get Workbook

Retrieve an existing workbook by ID.

Input Comments Default
Workbook ID The unique identifier for the workbook.
Timeout The maximum amount of time the client will await a response.
Connection

List Connections

Retrieve a list of connections from a Tableau workbook.

Input Comments Default
Workbook ID The unique identifier for the workbook.
Timeout The maximum amount of time the client will await a response.
Page Size The maximum number of results to return.
Page Number The page offset for the given object's results.
Connection

List Projects

Retrieve a list of projects from a Tableau site.

Input Comments Default
Timeout The maximum amount of time the client will await a response.
Page Size The maximum number of results to return.
Page Number The page offset for the given object's results.
Connection

List Users

Retrieve a list of users from a Tableau site.

Input Comments Default
Timeout The maximum amount of time the client will await a response.
Page Size The maximum number of results to return.
Page Number The page offset for the given object's results.
Connection

List Webhooks

Retrieve a list of all the webhooks on the specified site.

Input Comments Default
Timeout The maximum amount of time the client will await a response.
Page Size The maximum number of results to return.
Page Number The page offset for the given object's results.
Connection
API Version The version of the Tableau API to use. 3.6

List Workbooks

Retrieve a list of workbooks from a Tableau site.

Input Comments Default
Timeout The maximum amount of time the client will await a response.
Page Size The maximum number of results to return.
Page Number The page offset for the given object's results.
Connection

Publish Workbook

Publish a workbook on the specified site.

Input Comments Default
Timeout The maximum amount of time the client will await a response.
Connection
Upload Session ID When committing a file that was uploaded in parts, this value contains the upload session ID generated by a call to Initiate File Upload.
Workbook Type The file format of the uploaded workbook: twb for a workbook file or twbx for a packaged workbook file.
Overwrite When true, overwrites a workbook that has the same name. When false, the request fails if the specified workbook already exists. false
As Job When false, the workbook publishing process runs synchronously and may time out for very large workbooks. When true, the process runs asynchronously and a job starts to perform the publishing process and return the job ID. false
Skip Connection Check When true, the Tableau server does not check whether a non-published connection of a workbook is reachable. false
Workbook XML The XML request body describing the workbook to publish. Must be a valid tsRequest document.
Workbook File Contents The twbx file to upload as binary data.

Raw Request

Send raw HTTP request to Tableau.

Input Comments Default
Connection
URL Input the path only (/projects); the base URL is already included (https://{inputHostName}/api/{inputApiVersion}/sites/{siteId}). For example, to connect to https://{inputHostName}/api/{inputApiVersion}/sites/{siteId}/projects, enter only /projects in this field. Note: {inputHostName} is derived from the Host Name input in the connection configuration, {inputApiVersion} is based on the API Version input (default is 3.6), and {siteId} is automatically appended.
Method The HTTP method to use.
Data The HTTP body payload to send to the URL.
Form Data The Form Data to be sent as a multipart form upload.
File Data File Data to be sent as a multipart form upload.
File Data File Names File names to apply to the file data inputs. Keys must match the file data keys above.
Query Parameter A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Header A list of headers to send with the request.
Response Type The type of data you expect in the response. You can request json, text, or binary data. json
Timeout The maximum time that a client will await a response to its request
Debug Request Enabling this flag will log out the current request. false
Retry Delay (ms) The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. 0
Retry On All Errors If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. false
Max Retry Count The maximum number of retries to attempt. Specify 0 for no retries. 0
Use Exponential Backoff Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. false
API Version The version of the Tableau API to use. 3.6

Search Connections

Search for a specific connection in a workbook.

Input Comments Default
Workbook ID The unique identifier for the workbook.
Search The text value to search on.
Search Field The field to filter connections on.
Timeout The maximum amount of time the client will await a response.
Connection
Page Number The page offset for the given object's results.
Page Size The maximum number of results to return.

Search Projects

Search for a specific project by a string of text.

Input Comments Default
Search The text value to search on.
Search Field The field to search. Dates should follow the ISO format: 2016-05-04T21:24:49Z
Timeout The maximum amount of time the client will await a response.
Connection
Page Number The page offset for the given object's results.
Page Size The maximum number of results to return.

Search Users

Search for a specific user by a string of text.

Input Comments Default
Search Field The field to search. Dates should follow the ISO format: 2016-05-04T21:24:49Z
Search The text value to search on.
Timeout The maximum amount of time the client will await a response.
Connection
Page Number The page offset for the given object's results.
Page Size The maximum number of results to return.

Search Workbooks

Search for a specific workbook by a string of text.

Input Comments Default
Search Field The field to search.
Filter Operator The operator to use when searching.
Search The text value to search on.
Timeout The maximum amount of time the client will await a response.
Connection
Page Number The page offset for the given object's results.
Page Size The maximum number of results to return.

Test Webhook

Test the specified webhook by sending an empty payload to its configured destination URL and returning the server response.

Input Comments Default
Connection
Webhook ID The unique identifier for the webhook.
Timeout The maximum amount of time the client will await a response.
API Version The version of the Tableau API to use. 3.6

Update Connection

Update the information and metadata of an existing connection by ID.

Input Comments Default
Workbook ID The unique identifier for the workbook.
Connection ID The unique identifier for the connection.
Server Address The address of the server to connect to.
Server Port The port of the server to connect to.
Connection Username The username used to authenticate the connection.
Connection Password The password used to authenticate the connection.
Embed Password When true, embeds the password for the connection. false
Query Tagging Enabled When true, associates a server log query event with the Tableau resource that made the query. false
Timeout The maximum amount of time the client will await a response.
Connection

Update Project

Update the contents and metadata of an existing project by ID.

Input Comments Default
Project ID The unique identifier for the project.
Parent Project ID The unique identifier for the parent project.
Project Name The display name shown for the project in Tableau.
Content Permissions Controls user permissions in a project. A nested project inherits the parent's permissions and this setting has no effect.
Description A description of the project.
Timeout The maximum amount of time the client will await a response.
Connection

Update User

Update the information and metadata of an existing user.

Input Comments Default
User ID The unique identifier for the user.
Username The username of the user. For Tableau Online, this value is an email address.
Site Role The role assigned to the user on the site.
Auth Setting The authentication method used to sign the user in.
Timeout The maximum amount of time the client will await a response.
Connection

Update Webhook

Update the properties of an existing webhook.

Input Comments Default
Connection
Webhook ID The unique identifier for the webhook.
Webhook Name A descriptive label to identify the webhook in Tableau.
API Event Name The name of the Tableau event that triggers the webhook.
Webhook URL The destination URL for the webhook. The destination URL must use HTTPS and have a valid certificate.
Webhook Enabled When true, the newly created webhook is enabled. When false, the webhook is disabled. true
Webhook Disable Reason The reason a webhook is disabled.
Timeout The maximum amount of time the client will await a response.
API Version The version of the Tableau API to use. 3.6

Update Workbook

Update the information and metadata of an existing workbook by ID.

Input Comments Default
Workbook ID The unique identifier for the workbook.
Workbook Name The display name shown for the workbook in Tableau.
Project ID The unique identifier for the project.
User ID The unique identifier for the user.
Show Tabs When true, the updated workbook shows views in tabs. false
Timeout The maximum amount of time the client will await a response.
Connection