Reports - Update Report Content

Service:
Power BI REST APIs
API Version:
v1.0

Updates the specified report from "My Workspace" to have the same content as the report in the request body.

Required scope: Report.ReadWrite.All
To set the permissions scope, see Register an app.

POST https://api.powerbi.com/v1.0/myorg/reports/{reportId}/UpdateReportContent

URI Parameters

Name In Required Type Description
reportId
 path True
  • string
uuid

The report id

Request Body

Name Required Type Description
sourceReport True

Source from existing report
sourceType True

The source type for the content update.

Responses

Name Type Description
200 OK

OK

Examples

example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/reports/5b218778-e7a5-4d73-8187-f10824047715/UpdateReportContent
Request Body
{
  "sourceReport": {
    "sourceReportId": "8e4d5880-81d6-4804-ab97-054665050799",
    "sourceWorkspaceId": "2f42a406-a075-4a15-bbf2-97ef958c94cb"
  },
  "sourceType": "ExistingReport"
}

Sample Response

Status code:
200

Definitions

EndorsementDetails

Power BI endorsement details
Report

A Power BI report. Below is a list of properties that may be returned for a report. Only a subset of the properties will be returned depending on the API called, the caller permissions and the availability of the data in the Power BI database.
SensitivityLabel

Artifact sensitivity label info
SourceReport

Source from existing report
sourceType

The source type for the content update.
UpdateReportContentRequest

Power BI update report content request

EndorsementDetails

Power BI endorsement details

Name Type Description
certifiedBy
  • string

The user that certified the artifact
endorsement
  • string

The endorsement status

Report

A Power BI report. Below is a list of properties that may be returned for a report. Only a subset of the properties will be returned depending on the API called, the caller permissions and the availability of the data in the Power BI database.

Name Type Description
createdBy
  • string

The report owner
createdDateTime
  • string

The report created date time.
datasetId
  • string

The dataset id
description
  • string

The report description
embedUrl
  • string

The report embed url
endorsementDetails

The report endorsement details
id
  • string

The report id
modifiedBy
  • string

The user that modified this report
modifiedDateTime
  • string

The report modified date time.
name
  • string

The report name
reportType enum:
  • PaginatedReport

The report type
sensitivityLabel

The report sensitivity label
webUrl
  • string

The report web url

SensitivityLabel

Artifact sensitivity label info

Name Type Description
labelId
  • string

The sensitivity label ID

SourceReport

Source from existing report

Name Type Description
sourceReportId
  • string

source report id
sourceWorkspaceId
  • string

source worksapce id

sourceType

The source type for the content update.

Name Type Description
ExistingReport
  • string

Use an existing report as a source for updating the content of a target report.

UpdateReportContentRequest

Power BI update report content request

Name Type Description
sourceReport

Source from existing report
sourceType

The source type for the content update.