Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Power Bi Users API
version: v1.0
description: 'Operations tagged Users across 2 of this provider''s published API definitions: power-bi-client-swagger.json, power-bi-client-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.powerbi.com
security: []
tags:
- name: Users
paths:
/v1.0/myorg/RefreshUserPermissions:
post:
tags:
- Users
summary: Refreshes user permissions in Power BI
description: 'When a user is granted permissions to a workspace, app, or Power BI item (such as a report or a dashboard), the new permissions might not be immediately available through API calls. This operation refreshes user permissions to ensure they''re fully updated.
> [!IMPORTANT]
>
> - Call **Refresh User Permissions** before making other API calls.
> - Since it takes about two minutes for the permissions to get refreshed, wait for two minutes before making other API calls.
## Permissions
This API call can be called by a service principal profile. For more information see: Service principal profiles in Power BI Embedded.
## Required Scope
Workspace.Read.All or Workspace.ReadWrite.All
## Limitations
Maximum one call per user per hour.'
operationId: Users_RefreshUserPermissions
responses:
'200':
description: OK
x-ms-examples:
Example:
parameters: {}
responses:
'200': {}
deprecated: false
servers:
- url: https://api.powerbi.com
x-refined-from:
- power-bi-client-swagger.json
- power-bi-client-openapi.json