The Google Spectrum Access System (SAS) Portal API [user roles](https://docs.cloud.google.com/spectrum-access-system/docs/roles-and-permissions.md.txt#user-roles)
allow a user to make certain API calls based on their scope. These roles are
assigned to the user's Google Account.

## User roles

The roles assigned to a user are [`role_admin`](https://docs.cloud.google.com/spectrum-access-system/docs/roles-and-permissions.md.txt#admin)
and [`role_cpi`](https://docs.cloud.google.com/spectrum-access-system/docs/guides/roles-and-permissions#cpi).
Each user can be assigned to one or more roles.

### role_admin

The first user of a SAS customer's organization is the
*administrator*. The administrator is automatically added during the sign-up
process. The administrators can then add other users and assign them roles,
including the administrator role.

The administrator role has full administrative permissions for all of the child
[resources](https://docs.cloud.google.com/spectrum-access-system/docs/manage-resources.md.txt) under the parent
resource to which it has been granted access. The administrator sets up the
organization's structure within the SAS Portal and manages user
access.

### role_cpi

The [CPI](https://docs.cloud.google.com/spectrum-access-system/docs/key-terms.md.txt) role is for users who are
*Certified Professional Installers* . To be assigned this role, users need to
have an active CPI certification. To validate if a user has this certification,
use the [`ValidateInstaller()` method](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/v1alpha1/installer/validate.md.txt#spectrum.sas.portal.v1alpha1.DeviceManager.ValidateInstaller).

Only users with a validated `role_cpi` role can use the
[`SignDevice()` method](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/v1alpha1/deployments.devices/signDevice.md.txt)
to submit the installation parameters of CBSDs that
require CPI installation.

## Methods

The following table shows which roles can use each type of method.

| Methods | Roles |
|---|---|
| [`GetCustomer()`](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/customers/get.md.txt) | `role_admin` `role_cpi` |
| [`ListCustomers()`](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/customers/list.md.txt) | `role_admin` `role_cpi` |
| [`CreateDevice()`](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/customers.devices/create.md.txt) | `role_admin` `role_cpi` |
| [`GetDevice()`](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/customers.devices/get.md.txt) | `role_admin` `role_cpi` |
| [`ListDevices()`](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/customers.devices/list.md.txt) | `role_admin` `role_cpi` |
| [`UpdateDevice()`](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/customers.devices/patch.md.txt) | `role_admin` `role_cpi` |
| [`CreateSignedDevice()`](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/customers.devices/createSigned.md.txt) | `role_admin` `role_cpi` |
| [`UpdateSignedDevice()`](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/customers.devices/updateSigned.md.txt) | `role_admin` `role_cpi` |
| [`GenerateSecret()`](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/customers.devices/generateSecret) | `role_admin` `role_cpi` |
| [`ValidateInstaller()`](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/customers.devices/validate) | `role_admin` `role_cpi` |
| [`SignDevice()`](https://docs.cloud.google.com/spectrum-access-system/docs/reference/rest/customers.devices/signDevice.md.txt) | `role_cpi` (validated) |

## What's next

- To get an overview of the SAS Portal API, see [Google SAS Portal API overview](https://docs.cloud.google.com/spectrum-access-system/docs/overview-api.md.txt).
- For information about each API, see [Customers API](https://docs.cloud.google.com/spectrum-access-system/docs/customers-api.md.txt) and [Device Manager API](https://docs.cloud.google.com/spectrum-access-system/docs/device-manager-api.md.txt).
- For examples of how to use the API, see [API code samples](https://docs.cloud.google.com/spectrum-access-system/docs/samples.md.txt).
- For reference documentation, see [APIs and reference](https://docs.cloud.google.com/spectrum-access-system/docs/apis.md.txt).