NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #2071 most downloaded on PyPI
A Python module for working with the Tableau Server REST API.
Latest stable
0.42
Last release 1 months ago
15 Oct 2026
Release timing varies
gaps range from 2 weeks to 9 months
Nearly every release is documented
notes for 43 of 44 stable releases
2 versions withdrawn
withdrawn after publishing
10 years old
51 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Bump urllib3 floor to 2.6.3 for CVE-2026-21441 (PR \#1869) — closes a gap where urllib3's streaming decompression safeguards could be bypassed when HT…
Projects.get_by_path() for hierarchy-aware project lookup (PR #1804) — resolves a slash-separated path like "Marketing/Q1 Reports" to a ProjectItem (or None), walking the project tree level by level via the REST API name filter<statusNotes> into JobItem.status_notes (PR #1852) — exposes the structured per-row status notes (type/value/text) returned by the Query Job endpoint for jobs like UserImport, alongside the existing legacy notes listJobFailedException/JobCancelledException/FlowRun* exceptions at the top-level TSC namespace (PR #1870) — callers can now catch TSC.JobFailedException directly instead of reaching into the internal tableauserverclient.server.endpoint.exceptions moduleServer thread-safe with per-thread sessions (PR #1871) — each thread now gets its own requests.Session, closing a gap where concurrent callers shared one session and its connection pool/cookiesinclude-based setuptools config on newer setuptools; adds a packaging structure test to catch regressionsFilter serialization for datetimes and booleans (PR #1805) — datetime filter values were serialized with a space instead of ISO-8601 T/Z, and booleans serialized as Python's True/False instead of lowercase true/false, both of which caused server 400 errorsrequests was converting POST to GET and dropping the body on 301/302/303 redirects, causing 405 errors on users.add, workbooks.publish, and other writes behind a redirect; TSC now walks the redirect chain manually and refuses HTTPS→HTTP downgradesUserItem.CSVImport, including an off-by-one that rejected valid 8-column lines and destructive lowercasing of usernames/display names/emailscustomSubscriptionEmail and customSubscriptionFooter (PR #1851) — subscription footer text is shown verbatim in outgoing emails, so lowercasing it on serialization mangled company names and sentence casingcast issue in helpers/strings.py and a missing import in a test^M noise introduced accidentally by an earlier Black version bumpsamples/explore_workbook.py (PR #1881) — fixes a bare type annotation that left a variable unbound, plus two other pre-existing sample bugs surfaced by a fresh-eyes reviewtmp_path fixture in download tests to avoid cwd pollution (PR #1800) — download tests wrote to the current working directory, causing conflicts when run in parallel (-n auto); now use a worker-isolated temp directoryDownloadableMixin (PR #1803) — de-duplicates three identical streaming blocks across Workbooks, Datasources, and Flows into a single shared helperCSVImport._decompose_site_role (PR #1812) — moves the inverse of _evaluate_site_role into CSVImport and fixes three pre-existing bugs found along the wayConcatenate/ParamSpec/overload; align Black target-version (PR #1839) — removes no-op typing_extensions indirection now that the minimum supported Python is 3.10, and aligns Black's target versions with the supported/CI matrixresolve_credentials() for env-var-based sign-in, fixes samples that used .get() where pagination was intended, and adds new background-jobs/subscriptions sample scriptssamples/inspect_connection_details.py, demonstrating how to read connector-specific attributes (Oracle service, Snowflake schema, etc.) that aren't exposed via ConnectionItemRequestOptions.vf() wire-format rules (PR #1840), clarified username formats, ProjectLeader-as-group, and filter special-char behavior (PR #1854), one-line docstrings on root-level helper modules (PR #1859), expanded update_connection_auth sample header for Snowflake keypair auth (PR #1844) — documentation-only improvements, no behavior changeFull Changelog: https://github.com/tableau/server-client-python/compare/v0.41...v0.42
Your coding agent can read these notes before it upgrades. Set up the MCP server →
SVG format support for view images (PR #1772) — sheet images can now be downloaded as SVG in addition to PNG
Note: Earlier drafts of these notes described additional features and fixes (Extensions API, delete view, batch schedule, OIDC, and others). Those changes landed on
developmentafter v0.41 was tagged and will ship in v0.42. The v0.41 tag contains only PR #1772.
0.40 - fix packaging error in 0.39 by @jacalata in https://github.com/tableau/server-client-python/pull/1750
Full Changelog: https://github.com/tableau/server-client-python/compare/v0.39...v0.40
feat: New APIs: Update multiple connections in a single workbook/datasource
feat: New APIs: Update multiple connections in a single workbook/datasource (https://github.com/tableau/server-client-python/pull/1638)
feat: enable toggling attribute capture for a site (https://github.com/tableau/server-client-python/pull/1619)
feat: support OIDC endpoints (https://github.com/tableau/server-client-python/pull/1630)
feat: add WebAuthoringForFlows capability to Permission class (https://github.com/tableau/server-client-python/pull/1642)
feat: support collections in favorites (https://github.com/tableau/server-client-python/pull/1647)
feat: Add UAT (unified access token) support to JWT login (https://github.com/tableau/server-client-python/pull/1671)
feat: Update permissions_item.py --added ExtractRefresh attribute (https://github.com/tableau/server-client-python/pull/1617) (https://github.com/tableau/server-client-python/pull/1669)
feat: make refresh consistent between endpoints (https://github.com/tableau/server-client-python/pull/1665)
feat: make ResourceReference hashable (https://github.com/tableau/server-client-python/pull/1668) Closes https://github.com/tableau/server-client-python/issues/1666
feat: delete view (https://github.com/tableau/server-client-python/pull/1712)
feat: batch create schedule (https://github.com/tableau/server-client-python/pull/1714)
feat: users csv import (https://github.com/tableau/server-client-python/pull/1409)
feat: implement users bulk_remove
feat: enable idp_configuration_id in bulk_add
feat: support extensions api (https://github.com/tableau/server-client-python/pull/1672)
feat: Add support for receiving "Customized Monthly" schedule intervals (https://github.com/tableau/server-client-python/pull/1670)
feat: implement https://github.com/tableau/server-client-python/issues/816: project.get_by_id (https://github.com/tableau/server-client-python/pull/1736)
feat: enable retrieving only owned workbooks by @jorwoods in https://github.com/tableau/server-client-python/pull/1594
feat: Add fields:all support by @jorwoods in https://github.com/tableau/server-client-python/pull/1563
feat: Add SSL option for connecting to Tableau Server with a weaker DH key length by @bcantoni in https://github.com/tableau/server-client-python/pull/1596
1580 list extracts on schedule by @casey-crawford-cfa in https://github.com/tableau/server-client-python/pull/1604
fix: put special fields first (https://github.com/tableau/server-client-python/pull/1622) Closes https://github.com/tableau/server-client-python/issues/1620
fix: virtual connections username (https://github.com/tableau/server-client-python/pull/1628) Closes https://github.com/tableau/server-client-python/issues/1626
fix: add contentType to tags batch actions (https://github.com/tableau/server-client-python/pull/1643)
fix: datasource owner/project missing parsing (https://github.com/tableau/server-client-python/pull/1700)
fix: datasource description update and publish (https://github.com/tableau/server-client-python/pull/1682)
fix: windows decoding error
fix: assert on warning instead of ignore
fix: add workbook and view setter for custom view (https://github.com/tableau/server-client-python/pull/1730)
fix: handle parameters for view filters (https://github.com/tableau/server-client-python/pull/1633)
Full Changelog: https://github.com/tableau/server-client-python/compare/v0.38...v0.39
v0.38 - IDP configuration by @jacalata in https://github.com/tableau/server-client-python/pull/1606 *
v0.38 - IDP configuration by @jacalata in https://github.com/tableau/server-client-python/pull/1606
docs: docstrings for schedules and intervals (https://github.com/tableau/server-client-python/pull/1528)
docs: Docstrings for new fields
feat: enable retrieving only owned workbooks
feat: Add support for multiple IDPs (jorwoods)
feat: Add fields:all support (https://github.com/tableau/server-client-python/pull/1563)
feat: project support all fields
feat: groups all fields
feat: views support all fields
feat: user support all fields
feat: workbook support all fields
feat: datasourceitem all fields
feat: add fields methods to QuerySet
feat: add owner attribute to project
Add SSL option for connecting to Tableau Server with a weaker DH key length Fixes https://github.com/tableau/server-client-python/issues/1582
feat: 1580 list extracts on schedule (https://github.com/tableau/server-client-python/pull/1604)
chore: type hint database and table objects (https://github.com/tableau/server-client-python/pull/1593)
ci: Switch Slack action to use ubuntu-latest like our other actions.
Co-authored-by: Jordan Woods jorwoods@users.noreply.github.com Co-authored-by: Jordan Woods 13803242+jorwoods@users.noreply.github.com Co-authored-by: Brian Cantoni bcantoni@salesforce.com Co-authored-by: casey-crawford-cfa 91914995+casey-crawford-cfa@users.noreply.github.com
fix: Incorrect size unit when logging fileUpload by @KulykDmytro in https://github.com/tableau/server-client-python/pull/1560
Full Changelog: https://github.com/tableau/server-client-python/compare/v0.36...v0.37
Fixes a 400 Bad Request error when calling Refresh Datasource with 0.35
Fixes a 400 Bad Request error when calling Refresh Datasource with 0.35
feat: Workbook update Description by @LehmD in https://github.com/tableau/server-client-python/pull/1516
feat: Workbook update Description by @LehmD in https://github.com/tableau/server-client-python/pull/1516
feat: capture site content url from sign in by @jorwoods in https://github.com/tableau/server-client-python/pull/1524
fix: datasource id on ConnectionItem by @jorwoods in https://github.com/tableau/server-client-python/pull/1538
feat: support for thumbnail related options in workbook publish by @renoyjohnm in https://github.com/tableau/server-client-python/pull/1542
feat: incremental refresh for extracts by @jacalata in https://github.com/tableau/server-client-python/pull/1545
Fixing set default permissions for virtual connections by @TrimPeachu in https://github.com/tableau/server-client-python/pull/1535
feat: publish datasource as replacement by @jacalata in https://github.com/tableau/server-client-python/pull/1546
chore: Update versioneer by @jacalata in https://github.com/tableau/server-client-python/pull/1547
docs: docstrings for custom_views by @jorwoods in https://github.com/tableau/server-client-python/pull/1540
docs: webhook docstrings by @jorwoods in https://github.com/tableau/server-client-python/pull/1530
docs: task docstrings by @jorwoods in https://github.com/tableau/server-client-python/pull/1527
docs: docstrings for Pager and RequestOptions by @jorwoods in https://github.com/tableau/server-client-python/pull/1498
docs: docstrings for group endpoint and item by @jorwoods in https://github.com/tableau/server-client-python/pull/1499
docs: project docstrings by @jorwoods in https://github.com/tableau/server-client-python/pull/1505
docs: docstrings for JobItem and Jobs endpoint by @jorwoods in https://github.com/tableau/server-client-python/pull/1529
docs: docstrings on ConnectionItem and ConnectionCredentials by @jorwoods in https://github.com/tableau/server-client-python/pull/1526
docs: flow docstrings by @jorwoods in https://github.com/tableau/server-client-python/pull/1532
docs: docstrings for views by @jorwoods in https://github.com/tableau/server-client-python/pull/1523
Full Changelog: https://github.com/tableau/server-client-python/compare/v0.34...v0.35
Update requests library for CVE CVE-2024-35195 by @jacalata in https://github.com/tableau/server-client-python/pull/1507
Full Changelog: https://github.com/tableau/server-client-python/compare/v0.33...v0.34
Update contributors by @bcantoni in https://github.com/tableau/server-client-python/pull/1428
Full Changelog: https://github.com/tableau/server-client-python/compare/v0.32...v0.33
Remove blocks of code and arguments that have been deprecated #1380
Remove deprecated cgi package and switch to email.message.Message #1346
email.message.Message #1346Nothing published for this version
fix Unauthorized Error in 0.29 by @jacalata in https://github.com/tableau/server-client-python/pull/1345
Full Changelog: https://github.com/tableau/server-client-python/compare/v0.29...v0.30
Bump urllib3 from 2.0.4 to 2.0.7 by @dependabot
Full Changelog: https://github.com/tableau/server-client-python/compare/v0.28...v0.29
Nothing published for this version
Nothing published for this version
make project nullable on datasource https://github.com/tableau/server-client-python/issues/1210
Fix bug in update-datasources before 3.15 (https://github.com/tableau/server-client-python/pull/1203) (fixes https://github.com/tableau/server-client-
Add logic to retrieve Datarole and Metric permissions by @TrimPeachu in https://github.com/tableau/server-client-python/pull/1163
Co-authored-by: Marwan Baghdad mrwanbaghdad76@gmail.com Co-authored-by: jorwoods jorwoods@users.noreply.github.com Co-authored-by: Brian Cantoni bcantoni@salesforce.com Co-authored-by: TrimPeachu 77048868+TrimPeachu@users.noreply.github.com Co-authored-by: Stu Tomlinson stu@nosnilmot.com Co-authored-by: Jeremy Harris jercharris89@gmail.com
Fixed automated publishing of packages to PyPI. No code changes since v0.23.1.
Fixed automated publishing of packages to PyPI. No code changes since v0.23.1.
Nothing published for this version
Add custom session injection, Fix bug for http_options by @jacalata in https://github.com/tableau/server-client-python/pull/1119
Full Changelog: https://github.com/tableau/server-client-python/compare/v0.22...v0.23
Now also available on pypi! :)
Now also available on pypi! :)
Nothing published for this version
Add new samples and delete redundant ones
Switched to using defused_xml for xml attack protection added linting and type hints improve experience with self-signed certificates/invalid ssl upda
Switched to using defused_xml for xml attack protection added linting and type hints improve experience with self-signed certificates/invalid ssl updated samples new item types: metrics, revisions for datasources and workbooks features: support adding flows to schedules, exporting workbooks to powerpoint fixes: delete extracts
Added support for accepting parameters for post request of the metadata api
Full Changelog: https://github.com/tableau/server-client-python/compare/v0.16.0...v0.17.0
Documentation updates (#800, #818, #839, #842)
Added support for python version 3.9
Fixed filter query issue for server version below 2020.1
Added django-style filtering and sorting
Added webpage_url field to WorkbookItem
Added hidden_views parameter to workbook publish method
Added more fields to Data Acceleration config
Added a way to handle non-xml errors
Nothing published for this version
Added site settings for Data Catalog and Prep Conductor
## 0.8.1 (17 July 2019) * Fixed update_workbook endpoint
Added Max Age to download view image request
Added ability to rename workbook using update workbook
update workbook (#284)Expanded the enum for site roles
Fixed #257 where refreshing extracts does not work due to a missing "self"
Added support for add a datasource/workbook refresh to a schedule
Fix a critical issue caused by #224 that was the result of lack of test coverage
Added revision settings to update site
Fix #177 to remove left in debugging print
Added API version annotations to endpoints
Deprecated site in favor of site_id
Deprecated site as a parameter to TableauAuth in favor of site_id
site as a parameter to TableauAuth in favor of site_id* Initial Release to the world
One column per quarter.