Profiles API Overview

Learn more about the Profiles API.

The profiles APIs allows you to assign profiles to your users.

As an administrating tenant, your users that are assigned to an analytic tenant also need an analytic tenant profile assigned to them. These are implicitly assigned in Visier's UI, but must be explicitly assigned via API.

The following table shows how tenant profiles map across administrating and analytic tenants (excluding API users):

Administrating tenant profile

Analytic tenant profile

PARTNER_ADMIN

PARTNER_SERVICE_MGMT

PARTNER_SERVICE_MGR

PARTNER_CUSTOMER_SERVICE_MGR

Assign the Administrator profile to a new user:

  1. Create a new user at the administrating tenant level.
  2. Retrieve all available profiles for the administrating tenant. See v1/admin/profiles.
  3. Retrieve all available profiles for the analytic tenants. See v1/admin/profiles/accessible-tenants.
  4. Assign the administrating tenant profile PARTNER_ADMIN to the user. See v1/admin/profiles/{profile-id}/assign.
  5. Assign the analytic tenant profile PARTNER_SERVICE_MGMT to the user. See v1/admin/profiles/accessible-tenants/{profile-id}/assign.

Example: Assign an Administrator profile to a new user

Let's say the administrating tenant is WFF_j1r and the analytic tenants are WFF_j1r~i1o and WFF_j1r~c9o. For an Administrator, you must assign the PARTNER_ADMIN administrating tenant profile to a user for WFF_j1r, and then assign the PARTNER_SERVICE_MGMT analytic tenant profile to that user for each analytic tenant (WFF_j1r~i1o and WFF_j1r~c9o).

Assign the Partner Service Manager profile to a new user:

  1. Create a new user at the administrating tenant level.
  2. Retrieve all available profiles for the administrating tenant.
  3. Retrieve all available profiles for the analytic tenants.
  4. Assign the administrating tenant profile "PARTNER_SERVICE_MGR" to the user.
  5. Assign the analytic tenant profile "PARTNER_CUSTOMER_SERVICE_MGR" to the user.

Example: Assign the Partner Service Manager profile to a new user

Let's say the administrating tenant is WFF_j1r and the analytic tenant is WFF_j1r~i1o. For a Partner Service Manager, you must assign the PARTNER_SERVICE_MGR administrating tenant profile to a user for WFF_j1r. Then, assign the PARTNER_CUSTOMER_SERVICE_MGR analytic tenant profile to the analytic tenants that the user should have access to (in this example, only WFF_j1r~i1o).

Capabilities

A profile capability defines the actions users can perform in the studio experience. Capabilities set a user's access level and view level to different actions in the studio experience. All capabilities are disabled by default. Additional capabilities are either enabled or disabled. For more information about profile capabilities and additional capabilities, see Profile Capabilities.