Power BI icon

Power BI

Work with the Power BI API

Overview

The node integrates with the Power BI API to perform various operations on Power BI resources. Specifically, for the Dataset resource and the Refresh operation, it triggers a refresh of a specified dataset within a Power BI workspace (group). This is useful when you want to programmatically update the data in your Power BI reports and dashboards after the underlying data source has changed.

Common scenarios include:

  • Automating dataset refreshes as part of a data pipeline.
  • Triggering refreshes on-demand from other workflows or events.
  • Ensuring that reports and dashboards reflect the most recent data without manual intervention.

Example: After loading new sales data into a database, use this node to refresh the corresponding Power BI dataset so that reports show updated sales figures.

Properties

Name Meaning
Group (Workspace) Power BI group (workspace) ID where the dataset resides. Leave blank to use "My Workspace".
Dataset The ID of the dataset to be refreshed.
  • Group (Workspace): Selects the workspace containing the dataset. If left empty, the default personal workspace ("My Workspace") is used.
  • Dataset: Required. Specifies which dataset to refresh by its unique identifier.

Output

The node outputs JSON data representing the result of the refresh request. Typically, this includes status information about the refresh operation initiated on the dataset.

If the node supports binary data output (not indicated here), it would represent any binary content returned by the API, but for this operation, the output is purely JSON.

Dependencies

  • Requires an active connection to the Power BI API using an API key or OAuth token configured in n8n credentials.
  • The node depends on the Power BI REST API endpoint https://api.powerbi.com/v1.0/myorg.
  • The user must have appropriate permissions to trigger dataset refreshes in the specified workspace.

Troubleshooting

  • Common issues:

    • Invalid or missing dataset ID or group ID can cause errors.
    • Insufficient permissions to refresh datasets in the selected workspace.
    • API rate limits or service outages may prevent successful refresh.
  • Error messages:

    • "The resource 'dataset' is not supported!" — indicates an unsupported resource or operation was requested.
    • API errors related to authentication or authorization typically mean the credential setup needs review.
    • Network or timeout errors suggest connectivity issues with the Power BI service.
  • Resolutions:

    • Verify dataset and group IDs are correct and exist.
    • Ensure the API credentials have refresh permissions.
    • Check network connectivity and retry if transient errors occur.

Links and References

Discussion