Folder - Creates a new folder in the specified workspace

Creates a new folder in the specified workspace.

post

Authorizations

Bearer

HTTPRequired

Please enter a valid token

Path parameters

tenantIdstring · uuidRequired

The unique identifier of the workspace where the folder will be created.

Query parameters

versionstringOptional

The requested API version

Default: 1.0

Body

application/jsontext/jsonapplication/*+json

Request model for creating a folder in Power BI.

displayNamestring · nullableOptional

Gets or sets the display name of the folder.

parentFolderIdstring · uuid · nullableOptional

Gets or sets the parent folder ID. Null or empty if the folder is created at the root.

descriptionstring · nullableOptional

Gets or sets the description of the folder.

Responses

201

Created: The folder was successfully created.

text/plainapplication/jsontext/json

400

Bad Request: The request is invalid.

text/plainapplication/jsontext/json

401

Unauthorized: Access token is missing or invalid.

text/plainapplication/jsontext/json

403

Forbidden: Permission denied to create the folder.

text/plainapplication/jsontext/json

500

Internal Server Error: An unexpected error occurred or a server timeout.

text/plainapplication/jsontext/json

post

/folders/tenants/{tenantId}/folders/createFolder

HTTPcURLJavaScriptPython

POST /folders/tenants/{tenantId}/folders/createFolder HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "displayName": "text",
  "parentFolderId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text"
}

application/jsontext/jsonapplication/*+json

{
  "id": "text",
  "displayName": "text",
  "parentFolderId": "text",
  "workspaceId": "text"
}