---
canonical_url: "https://docs.composio.dev/toolkits/tableau"
markdown_url: "https://docs.composio.dev/toolkits/tableau.md"
product: "platform"
version: null
last_updated: null
---

# Tableau

Tableau is a visual analytics platform transforming the way we use data to solve problems

- **Category:** analytics
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `TABLEAU`
- **Version:** 00000000_00

## Tools

### Get Current Session

**Slug:** `TABLEAU_GET_CURRENT_SESSION`

Return the Tableau site and user identity established by the connected PAT, including their LUIDs and the user's current site role.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Server Info

**Slug:** `TABLEAU_GET_SERVER_INFO`

Return the connected Tableau deployment's product, build, and supported REST API versions. This public endpoint checks deployment compatibility but does not validate the PAT.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Workbook

**Slug:** `TABLEAU_GET_WORKBOOK`

Return one Tableau workbook by LUID, including its project, owner, tags, views, and freshness settings when available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workbook_id` | string | Yes | Workbook LUID returned by Tableau, usually obtained from LIST_WORKBOOKS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Data Sources

**Slug:** `TABLEAU_LIST_DATA_SOURCES`

List published data sources visible to the connected PAT on its signed-in Tableau site, with optional filtering and sorting, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Tableau sort expression controlling data-source order. |
| `filter` | string | No | Tableau filter expression for data-source fields such as name or updatedAt. |
| `page_size` | integer | No | Maximum data sources to return in this page (1-1000). |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged and omit filter, sort, and page_size; omit it to start a new query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Groups

**Slug:** `TABLEAU_LIST_GROUPS`

List groups the connected PAT is permitted to see on its signed-in Tableau site, with optional filtering and sorting, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Tableau sort expression controlling group order. |
| `filter` | string | No | Tableau filter expression for group fields such as name. |
| `page_size` | integer | No | Maximum groups to return in this page (1-1000). |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged and omit filter, sort, and page_size; omit it to start a new query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Jobs

**Slug:** `TABLEAU_LIST_JOBS`

List active asynchronous jobs the connected PAT is permitted to see on its signed-in Tableau site, optionally narrowed with a Tableau filter expression, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | Tableau filter expression for narrowing returned jobs; omit to request all active jobs visible to the connected PAT. |
| `page_size` | integer | No | Maximum jobs to return in this page (1-1000). |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged and omit filter and page_size; omit it to start a new query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Projects

**Slug:** `TABLEAU_LIST_PROJECTS`

List projects visible to the connected PAT on its signed-in Tableau site, with optional filtering and sorting, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Tableau sort expression controlling project order. |
| `filter` | string | No | Tableau filter expression for project fields such as name, ownerName, or parentProjectId. |
| `page_size` | integer | No | Maximum projects to return in this page (1-1000). |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged and omit filter, sort, and page_size; omit it to start a new query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Users

**Slug:** `TABLEAU_LIST_USERS`

List users the connected PAT is permitted to see on its signed-in Tableau site, with optional filtering and sorting, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Tableau sort expression controlling user order. |
| `filter` | string | No | Tableau filter expression for user fields such as name or lastLogin. |
| `page_size` | integer | No | Maximum users to return in this page (1-1000). |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged and omit filter, sort, and page_size; omit it to start a new query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Views

**Slug:** `TABLEAU_LIST_VIEWS`

List views visible to the connected PAT on its signed-in Tableau site, with optional filtering, sorting, and usage statistics, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Tableau sort expression controlling view order. |
| `filter` | string | No | Tableau filter expression for supported view fields, including a view name when searching by name. |
| `page_size` | integer | No | Maximum views to return in this page (1-1000). |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged and omit filter, sort, include_usage_statistics, and page_size; omit it to start a new query. |
| `include_usage_statistics` | boolean | No | Whether to include view usage statistics when the connected user has permission. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workbooks

**Slug:** `TABLEAU_LIST_WORKBOOKS`

List workbooks visible to the connected PAT on its signed-in Tableau site, with optional filtering and sorting, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Tableau sort expression controlling workbook order. |
| `filter` | string | No | Tableau filter expression for workbook fields such as name, tags, or createdAt. |
| `page_size` | integer | No | Maximum workbooks to return in this page (1-1000). |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Pass it back unchanged and omit filter, sort, and page_size; omit it to start a new query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |