Find Open Tableau Studio Windows
Discovers the running local Tableau Studio instances the server can connect to and returns each one's session id, along with its loopback base URL, reported API version (when advertised), and whether an authentication token is present. Use the returned session id in the session parameter of the other Tableau Studio tools to target a specific instance.
APIs called
This tool does not call the Tableau Studio External Client API. It discovers instances by reading local discovery state that each running Tableau Studio publishes, so there is no per-instance route request and no External Client API call.
- Find running instances — reads the per-instance discovery records that each running Tableau Studio writes to a local application-data directory, keeps only the records it can parse, and drops any whose operating-system process is no longer alive. This is a local filesystem read plus an in-process liveness check; no
External Client APIcall is made, so there is no route to ground here.
Each discovered instance advertises a loopback base URL (for example http://127.0.0.1:8765) and a per-session bearer token. That token is the auth used to reach the instance's External Client API over the loopback interface, and it is how every other Tableau Studio tool authorizes its calls; this tool only reports whether a token is present (hasToken) and never returns the token itself.
Notes and caveats
- The session id is the running Tableau Studio instance's operating-system process id, returned as a string. Pass it in the
sessionparameter of other tools to control that instance. - Instances are returned newest-first, based on when each instance started.
- Only the presence of an authentication token is reported, via the boolean
hasToken; the token value is never included in the result. - When no running instances are discovered, the tool returns an error (HTTP 404) rather than an empty list, prompting the caller to confirm that Tableau Studio is running and reachable.
- The
messagefield still names the product "Tableau Desktop", as shown in the example below. That is the literal text the tool returns today and is reproduced here verbatim; read it as Tableau Studio.
Example results
Instances found
{
"message": "Found 2 running Tableau Desktop instances (External Client API).",
"instances": [
{
"sessionId": "77700",
"pid": 77700,
"baseUrl": "http://127.0.0.1:8765",
"apiVersion": "1.0",
"hasToken": true
},
{
"sessionId": "26928",
"pid": 26928,
"baseUrl": "http://127.0.0.1:8766",
"hasToken": true
}
],
"instructions": "Use the session ID of the instance you want to use in the session parameter of other tools."
}
No running instances
When nothing is discovered, the tool returns an error result (HTTP 404) reporting that no running Tableau Studio instances were found and prompting the caller to confirm that Tableau Studio is running and that its discovery information is available.