---
schema_version: "1"
id: c5d308207d467262bc474039ea321f481746c646ff8fda2c08e3da141ffa223e
title: Updated Site Roles in REST API 3.0 and Later
collection: tableau
version: current
locale: en-us
portal_url: https://docs.salesforce.com/tableau/current/en-us/api/rest_api/REST/rest_api_concepts_new_site_roles.md
canonical_url: https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_new_site_roles.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 8cdbd98a9f164c62972074de6b9787e48fae5c638fe45d6ee104e4ce0baee73c
description: Starting with the 2018
---
[Skip to main content](#main-content)

# Updated Site Roles in REST API 3.0 and Later

Starting with the 2018.1 release of Tableau Server and Tableau Cloud, available site roles have changed significantly to support the user-based Creator, Explorer and Viewer licenses. These changes affect the values sent to or returned from the following methods in REST API 3.0 and later:

- [Add User to Group](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#add_user_to_group)
- [Add User to Site](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#add_user_to_site)
- [Create Group](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#create_group)
- [Get Users in Group](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#get_users_in_group)
- [Get Users on Site](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#get_users_on_site)
- [Update Group](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#update_group)
- [Update User](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#update_user)

## Changes for the userQuota licensing attribute

In REST API versions 2.8 and earlier, the _userQuota_ attribute was used with the following methods to get the number of licensed users:

- [Create Site](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#create_site)
- [Query Site](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#query_site)
- [Query Sites](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#query_sites)
- [Update Site](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#update_site)

In REST API 3.0 and later, userQuota is the sum of licensed site users with Creator, Explorer, or Viewer roles. An administrator can get the userQuota value using the Update Site, Query Site, and Query Sites methods. Administrators of on premise servers can also set the userQuota value using the Create Site or Update Site methods.

- _tierCreatorCapacity_: Used to get or set the number of users with a Creator license.
- _tierExplorerCapacity_: Used to get or set the number of users with an Explorer license.
- _tierViewerCapacity_: Used to get or set the number of users with a Viewer license.

For REST API versions 3.7 and higher, specific quotas can be set for each role instead of setting a userQuota value. As with previous REST API versions, online admins can get the values of userQuota or tiered capacities, and on premise server admins can set the values.

To set specific quotas for each role on an on premise server, a Create Site or Update Site request should omit userQuota (set it to null), and provide a numerical value for for each of the tiered capacity attributes:

- _tierCreatorCapacity_: Used to get or set the number of users with a Creator license.
- _tierExplorerCapacity_: Used to get or set the number of users with an Explorer license.
- _tierViewerCapacity_: Used to get or set the number of users with a Viewer license.

## Changes to legacy site roles

As part of the introduction of new user-based license types, several legacy site roles have been renamed, as follows:

<table class="api-error-table"><colgroup><col style="width: 177px;"> <col style="width: 202px;"> <col> <col></colgroup><tbody><tr><th>Legacy Site role name (v10.5)</th><th>REST API site role string (v10.5)</th><th>Site role name</th><th>REST API site role string</th></tr><tr><td>Interactor</td><td><code>Interactor</code></td><td>Explorer</td><td><code>Explorer</code></td></tr><tr><td>Publisher</td><td><code>Publisher</code></td><td>Explorer (Can Publish)</td><td><code>ExplorerCanPublish</code></td></tr><tr><td>Site Administrator</td><td><code>SiteAdministrator</code></td><td>Site Administrator Explorer</td><td><code>SiteAdministratorExplorer</code></td></tr></tbody></table>

The following site roles were introduced in version 2018.1:

<table class="api-error-table"><colgroup><col style="width: 177px;"> <col style="width: 224px;"></colgroup><tbody><tr><th>Site role name</th><th>REST API site role string</th></tr><tr><td>Viewer</td><td><code>Viewer</code></td></tr><tr><td>Creator</td><td><code>Creator</code></td></tr><tr><td>Site Administrator Creator</td><td><code>SiteAdministratorCreator</code></td></tr></tbody></table>

The following site legacy site role names are unchanged:

<table class="api-error-table"><colgroup><col style="width: 177px;"> <col style="width: 224px;"></colgroup><tbody><tr><th>Site role name</th><th>REST API site role string</th></tr><tr><td>Server Administrator</td><td><code>ServerAdministrator</code></td></tr><tr><td>Unlicensed</td><td><code>Unlicensed</code></td></tr></tbody></table>

To learn more about licensing, see [Licensing Overview](https://help.tableau.com/current/server/en-us/license_server_overview.htm). To learn more about site roles, see [Set Users' Site Roles](https://help.tableau.com/current/server/en-us/users_site_roles.htm).