The Power BI service and Power BI Embedded in Azure are coming together to offer a single API for embedding your dashboards and reports.

This means you will have one API surface, a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and app workspaces – when embedding your content.

A single API

The Power BI REST APIs are being updated to allow for the use of an embed token. This will allow you to embed dashboards and reports into your customer application and give you the control of managing your users and mapping them to a Power BI service user.

You can take full advantage of the JavaScript and REST APIs for your embedding needs.

Embedding without an embed token

You can continue to embed content from the Power BI service into your applications using the REST API. This requires that the you sign into the Power BI service when you want to view your content in the application. For more information on how to do this, see the following.

Embedding with an embed token

You can use an embed token with the Power BI REST APIs to embed reports by using a single Power BI user. The embed token is then used with requests made by users in your application to view content within Power BI by way of a single Power BI user. The users within your application do not need to exist within your Power BI organization. The embed token is what makes it possible.

To embed dashboards, reports and tiles, you would use the same APIs that you did without an embed token. When the new embedding updates are rolled out, we will update these steps with how to use an embed token.

Using an embed token allows you to use a single Power BI user with your application. The embed token is generated based on authentication of that single Power BI user and you can then use that token with multiple users within your application. Those users within your application to not need to be represented within your Power BI organization or have any licenses.

Important:

While embedding has a dependency on the Power BI service, there is not a dependecy on Power BI for the users of your application when using an embed token. They do not need to sign up for Power BI to view the embedded content in your application.

For details on how to take advantage of an embed token, see Use an embed token when embedding dashboards and reports.

If you were using the Power BI Embedded service within Azure, see Migrate content from the Power BI Embedded Azure service for information on how to migrate your content over. If you never used Power BI Embedded, you can get started with using the embed token when it becomes available!

Next steps

Use an embed token when embedding
How to migrate Power BI Embedded workspace collection content to Power BI
JavaScript API Git repo
Power BI C# Git repo
JavaScript embed sample
Power BI Premium whitepaper
More questions? Try the Power BI Community