Tenant - Onboards a workspace as a tenant

Onboards an existing Power BI workspace as a logical tenant, ensuring the service principal has been granted 'Admin' access beforehand.

post

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

Authorizations

Query parameters

tenantNamestringRequired

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

tenantIdstring · uuidRequired

Enter the ID of an existing Power BI workspace.

onboardUserstring · enumRequired

Enum for onboarding user.

Available options:

versionstringOptional

The requested API version

Default: 1.0

Responses

text/plainapplication/jsontext/json

objectOptional

Class for representing response.

text/plainapplication/jsontext/json

text/plainapplication/jsontext/json

post

HTTPcURLJavaScriptPython

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

{
  "message": "text",
  "statusCode": 1
}