Datasets - Refresh Dataset

Triggers a refresh for the specified dataset from My workspace.

Required scope

Dataset.ReadWrite.All

Limitations

  • For Shared capacities, a maximum of eight requests per day, which includes refreshes executed using a scheduled refresh.
  • For Premium capacities, the maximum requests per day is only limited by the available resources in the capacity. If available resources are overloaded, refreshes are throttled until the load is reduced. The refresh will fail if throttling exceeds 1 hour.
POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes

URI Parameters

Name In Required Type Description
datasetId
path True
  • string

The dataset ID

Request Body

Name Required Type Description
notifyOption True

Mail notification options

Responses

Name Type Description
202 Accepted

Accepted

Examples

example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
{
  "notifyOption": "MailOnFailure"
}

Sample Response

Definitions

NotifyOption

Mail notification options

RefreshRequest

Power BI refresh request

NotifyOption

Mail notification options

Name Type Description
MailOnCompletion
  • string

A mail notification indicating success or failure will be sent on refresh completion

MailOnFailure
  • string

A mail notification will be sent on refresh failure

NoNotification
  • string

No notification will be sent

RefreshRequest

Power BI refresh request

Name Type Description
notifyOption

Mail notification options