Clone tile

 

Updated: September 13, 2017



Request | Response

Clone tile makes a copy of the requested tile in the target dashboard in the target workspace.

By passing the target report id and target dataset id within the request body, you can rebind the tile to a different report and dataset.

If target report id and target dataset are missing, the following will occur.

  • If you are cloning a tile within the same workspace, the report and dataset links will be cloned from the source tile.
  • If you are cloning a tile within a different workspace, report and dataset links will be rested. The tile will be broken.

POST https://api.powerbi.com/v1.0/myorg/dashboards/{dashboard_id}/tiles/{tile_id}/Clone

Groups

Groups are a collection of unified Azure Active Directory groups that the user is a member of and is available in the Power BI service. These are referred to as app workspaces within the Power BI service. To learn how to create a group, see Create an app workspace.

POST https://api.powerbi.com/v1.0/myorg/groups/{group_id}/dashboards/{dashboard_id}/tiles/{tile_id}/Clone

Uri parameter

NameDescriptionData Type
group_idGuid of the Group to use. You can get the group id from the Get Groups operation. Groups are referred to as app workspaces within the Power BI service.String
dashboard_idGuid of the dashboard that the tile belongs to. You can get the dashboard id from the Get dashboards operation.String
tile_idGuid of the tile that you want to clone. You can get the tile id from the Get tiles operation.String

Header

Authorization: Bearer eyJ0eX ... FWSXfwtQ

Content-Type

application/json

Body schema

ParameterRequiredDescription
TargetDashboardIdRequiredThe destination dashboard of the tile.
TargetWorkspaceIdRequiredThe destination workspace that the dashboard is located in. A workspace is the group that you are in. To stay in the same workspace that the tile is currently in, supply the group_id here. You can get the group id from the Get Groups operation. Groups are referred to as app workspaces within the Power BI service.
TargetReportIdOptionalThe report that the tile is bound to.
TargetModelIdOptionalThe dataset that the tile is bound to.
PositionConflictActionOptionalValid values: Tail or Abort

PositionConflictAction determines what to do if the position of the cloned tile overlaps another existing tile in the dashboard.
{  
   "TargetDashboardId":"df9f0e94-31df-450b-b97f-4461a7e4d308",
   "TargetWorkspaceId":"000588f5-56b1-4a33-a690-fc25343d3fae",
   "TargetReportId":"",
   "TargetModelId":""
   "PositionConflictAction":"Tail|Abort"
}

{
  "id": "string",
  "name": "string",
  "webUrl": "string",
  "embedUrl": "string",
  "datasetId": "string"
}

Status code

CodeDescription
200OK. Indicates success.
400Bad request. Invalid Post body.
404Not found
403Unauthorized
500Internal service error
Show: