v5

latestOpenAPI 3.1.02026-08-081,0211,3082.1 MB
Business Intelligence
Dashboards
Dashboards
Tableau

Get Tableau projects using connection credentials

Fetch all Tableau projects from a Tableau server using provided connection details.

Two modes:

  • Wizard (no datastore_id): caller supplies plaintext PAT in the body.
  • Add-site modal (datastore_id present, PAT omitted): falls back to credentials stored on the existing data store. The caller-supplied site_name lets the customer browse projects on a new site without re-entering the PAT.

PAT credentials are treated atomically — if the caller supplies only one of pat_name/pat_secret, the stored pair replaces both. This prevents a partial override from silently pairing the caller's new name with the stored secret.

Returns a hierarchical list of projects.

post/business_intelligence/tableau/projects

Request body

urlstring nullable
site_namestring nullable
pat_namestring nullable
pat_secretstring nullable
datastore_idinteger nullable
source_site_namestring nullable

Response

Successful Response

idstring required
namestring required
parent_project_idstring nullable
descriptionstring nullable
pathstring nullable
content_permissionsstring nullable