Tenant - Onboard an existing Power BI workspace as a logical tenant

Onboards an existing Power BI workspace as a logical tenant

post

Please first grant 'Admin' access to the service principal on your workspace

Authorizations

Bearer

HTTPRequired

Please enter a valid token

Query parameters

tenantNamestringRequired

Expects a name for the new tenant(to be onboarded workspace)

tenantIdstring · uuidRequired

Expects Id of an existing Power BI workspace

onboardUserstring · enumRequired

Enum for onboarding user.

Possible values:

versionstringOptional

The requested API version

Default: 1.0

Responses

200

Indicates successful onboard of the request workspace as a tenant

text/plainapplication/jsontext/json

Class for representing response.

messagestring · nullableOptional

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.

Default: Success Message

statusCodeinteger · int32Optional

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.

Default: 200

409

Indicates that the requested workspace me already exist with the same name or Id

text/plainapplication/jsontext/json

500

Server related error

text/plainapplication/jsontext/json

post

/tenants/onboard

HTTPcURLJavaScriptPython

POST /tenants/onboard?tenantName=text&tenantId=123e4567-e89b-12d3-a456-426614174000&onboardUser=enabled HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

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