Del via

Admin - Pipelines DeleteUserAsAdmin

  • Reference
Service:
Power BI REST APIs
API Version:
v1.0

Removes user permissions from a specified deployment pipeline.

Permissions

The user must have administrator rights.

Required Scope

Tenant.ReadWrite.All

Limitations

Maximum 200 requests per hour. 

DELETE https://api.powerbi.com/v1.0/myorg/admin/pipelines/{pipelineId}/users/{identifier}

URI Parameters

Name In Required Type Description
identifier
 path True

string

For the principal type User, provide the user principal name (UPN). Otherwise, provide the Object ID of the principal.
pipelineId
 path True

string

uuid

The deployment pipeline ID

Responses

Name Type Description
200 OK

OK

Examples

Remove group access to a deployment pipeline example
Remove service principal access to a deployment pipeline example
Remove user access to a deployment pipeline example

Remove group access to a deployment pipeline example

Sample request

DELETE https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users/5dba60b0-d9a7-42a3-b12c-6d9d51e7739a

Sample response

Status code:
200

Remove service principal access to a deployment pipeline example

Sample request

DELETE https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users/a35d842b-90d5-59a1-c56a-5f8fcff0bf9d

Sample response

Status code:
200

Remove user access to a deployment pipeline example

Sample request

DELETE https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users/john@contoso.com

Sample response

Status code:
200