capabilities.work

Provision a Workspace and Grant Access

A 3-step recipe with Power BI. We can help you get access.

Recipe · 3 steps

Provision a Workspace and Grant Access

Create a workspace and grant a principal access to it.

  1. Create the workspace. The service returns the generated workspace identifier, which every subsequent group-scoped call depends on.
  2. Grant the principal the requested access right on the new workspace. The call returns 200 with no body, so membership is verified by reading back.
  3. List the workspace users to confirm the grant was applied and to capture the resulting membership for the provisioning record.
What you'll need to have ready
  • workspaceName: The display name for the new workspace.
  • userEmail: The email address of the principal to grant access to.
  • groupUserAccessRight: The access right to grant. One of Admin, Member, Contributor, or Viewer.
  • principalType: The kind of principal being granted access. One of User, Group, or App.
For your developer

Arazzo workflow power-bi:workspace-provision-access, 3 operations: createGroup → addGroupUser → getGroupUsers. Specs on APIs.io.