Admin - Groups RestoreDeletedGroupAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Restores a deleted workspace.

Use this API call to restore workspaces.

Permissions

The user must have administrator rights (such as Office 365 Global Administrator or Power BI Service Administrator).

Required Scope

Tenant.ReadWrite.All

Limitations

Maximum 200 requests per hour.

POST https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/restore

URI Parameters

Name	In	Required	Type	Description
groupId	path	True	string uuid	The workspace ID

Request Body

Name	Required	Type	Description
emailAddress	True	string	The email address of the owner of the group to be restored
name		string	The name of the group to be restored

Responses

Name	Type	Description
200 OK		OK

Examples

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/3bec11ee-48a9-490c-8e4d-1ebba90d491a/restore

Request Body

{
  "name": "Restored Workspace",
  "emailAddress": "john@contoso.com"
}

Sample Response

Status code:

200

Definitions

GroupRestoreRequest

A Power BI request to restore a deleted group

Name	Type	Description
emailAddress	string	The email address of the owner of the group to be restored
name	string	The name of the group to be restored