View as Markdown
Microsoft Power BI icon

Microsoft Power BI ACTION

Get Refresh History

Get the refresh history for a Power BI dataset. Use List Datasets first to resolve a dataset name → datasetId. Pass workspaceId (from List Workspaces) or workspaceName to scope to a specific workspace, or omit both for My workspace. Each entry includes requestId, refreshType (OnDemand, Scheduled, ViaApi, etc.), startTime, endTime, status (Completed, Failed, Disabled, Cancelled, UnknownUnknown means still in progress), and serviceExceptionJson on failures. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Microsoft Power BI account once, then configure and run Get Refresh History from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "microsoft_power_bi-get-refresh-history",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    microsoft_power_bi: { authProvisionId: "apn_xxxxxxx" },
    datasetId: "Dataset ID",
    workspaceId: "Workspace ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get Refresh History inputs
Property Type Description
datasetId Dataset ID string
ID of the dataset. Use List Datasets to find IDs by name.
Required
workspaceId Workspace ID string
ID of the workspace. Use the List Workspaces tool to see accessible workspaces. Omit to target My workspace.
Optional
workspaceName Workspace Name string
Name of the workspace (alternative to Workspace ID). Use the List Workspaces tool to see accessible workspaces.
Optional
top Top integer
Number of refresh entries to return (most recent first). Max 200. Omit to return the default page.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
microsoft_power_bi-get-refresh-history
Version
0.0.3
App
Microsoft Power BI
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes