KNOWLEDGE BASE

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


Published: 23 Mar 2018
Last Modified Date: 18 May 2018

Issue

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

"Unauthorised"

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

Environment

Tableau Server 

Resolution

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. 

Cause

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" /> 
</xs:restriction> 
</xs:simpleType> 
Did this article resolve the issue?