Workspace - Add a user to the Power BI workspace with some requested access

Adds a user to the Power BI workspace with some requested access

POST/tenants/{tenantId}/pbiUsers

Authorization

Bearer

Path parameters

tenantId*string (uuid)

Expects Id of an existing tenant

Query parameters

Body

application/jsontext/jsonapplication/*+json

"UserIdentifier": Email Id of user in case of User or object Id in case of service principle or group
"GroupUserAccessRightEnum": Should be Member/Admin/Contributor/Viewer
"PrincipalTypeEnum": Should be User/App/Group

userIdentifiernullable string

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the UserIdentifier property.

groupUserAccessRightenum

Enum for group user access right.

NoneMemberAdminContributorViewer

principalTypeenum

Enum for principal type.

NoneUserGroupApp

Response

200404500

Indicates successful addition of user to a workspace

Body

text/plainapplication/jsontext/json

messagenullable string

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the Message property.

statusCodeinteger (int32)

A public property of type integer that has both a getter and a setter method, which allows for getting and setting the value of the StatusCode property.

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/tenants/{tenantId}/pbiUsers', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200404500

{
  "message": "Success Message",
  "statusCode": 200
}