---
title: "Get Tableau projects using connection credentials"
method: POST
path: "/business_intelligence/tableau/projects"
tags: ["Business Intelligence", "Dashboards", "Dashboards", "Tableau"]
---

# Get Tableau projects using connection credentials

`POST /business_intelligence/tableau/projects`

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.

## Request body

- TableauProjectsRequest — Request model for fetching Tableau projects before datastore creation.
  - `url` string, nullable
  - `site_name` string, nullable
  - `pat_name` string, nullable
  - `pat_secret` string, nullable
  - `datastore_id` integer, nullable
  - `source_site_name` string, nullable

## Response `200`

Successful Response

- TableauProject[]
  - `id` string, required
  - `name` string, required
  - `parent_project_id` string, nullable
  - `description` string, nullable
  - `path` string, nullable
  - `content_permissions` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/103580dad816/schema)