Error "Unauthorised" When Attempting to Run a REST API Command to List Sites on a Tableau Server

Published: 23 Mar 2018
Last Modified Date: 13 Jan 2019


When running a REST API command to list sites on a Tableau Server, the command fails and an error is returned:


Additionally, this behavior occurs if one of the sites is locked (such as when exporting a site).


Tableau Server 


As a Tableau Server Administrator, upgrade to Tableau Server 2018.1.1, 10.5.4, 10.4.7 or a later version. For more information, see Upgrading Tableau Server in Tableau Help. 


Currently REST API schema recognises only two possible site states: Active and Suspended. So the command to list sites fails when the state returned is "Locked".

This behavior is related to a known issue (ID: 752582) which has been fixed in a recent release of Tableau Server. 

Additional Information

For more information about the following list, see XML Schema REST API XML Schema
<xs:simpleType name="stateType"> 
<xs:restriction base="xs:string"> 
<xs:enumeration value="Active" /> 
<xs:enumeration value="Suspended" /> 

Discuss this article... Feedback Forum
Did this article resolve the issue?