Edit

Share via

Workspaces - Create Workspace

Service:
Core
API Version:
v1

Creates a new workspace.

Permissions

Required Delegated Scopes

Workspace.ReadWrite.All

Microsoft Entra supported identities

This API supports the Microsoft identities listed in this section.

Identity Support
User Yes
Service principal and Managed identities Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces

Request Body

Name Required Type Description
displayName True

string

The workspace display name.
The display name cannot contain more than 256 characters.
Only unused workspace names are allowed.
"Admin monitoring" is a reserved workspace name.
capacityId

string (uuid)

The ID of the capacity to assign the workspace to.
description

string

The workspace description.
The description cannot contain more than 4000 characters.
domainId

string (uuid)

The ID of the domain to assign the workspace to.

Responses

Name Type Description
201 Created

Workspace

Successfully created.

Headers

Location: string
Other Status Codes

ErrorResponse

Common error codes:

  • DomainNotFound - The provided domain was not found

  • InsufficientPermissionsToDomain - User permission to the domain is not sufficient to perform the operation

  • UnknownError - An error occurred.

Examples

Create a workspace example

Sample request

POST https://api.fabric.microsoft.com/v1/workspaces

{
  "displayName": "New workspace"
}

Sample response

Status code:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb22287ff
{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb22287ff",
  "displayName": "New workspace",
  "description": "",
  "type": "Workspace"
}

Definitions

Name Description
CreateWorkspaceRequest

Create workspace request payload.
ErrorRelatedResource

The error related resource details object.
ErrorResponse

The error response.
ErrorResponseDetails

The error response details.
Workspace

A workspace object.
WorkspaceType

A workspace type. Additional workspace types may be added over time.

CreateWorkspaceRequest

Object

Create workspace request payload.

Name Type Description
capacityId

string (uuid)

The ID of the capacity to assign the workspace to.
description

string

The workspace description.
The description cannot contain more than 4000 characters.
displayName

string

The workspace display name.
The display name cannot contain more than 256 characters.
Only unused workspace names are allowed.
"Admin monitoring" is a reserved workspace name.
domainId

string (uuid)

The ID of the domain to assign the workspace to.

ErrorRelatedResource

Object

The error related resource details object.

Name Type Description
resourceId

string

The resource ID that's involved in the error.
resourceType

string

The type of the resource that's involved in the error.

ErrorResponse

Object

The error response.

Name Type Description
errorCode

string

A specific identifier that provides information about an error condition, allowing for standardized communication between our service and its users.
message

string

A human readable representation of the error.
moreDetails

ErrorResponseDetails[]

List of additional error details.
relatedResource

ErrorRelatedResource

The error related resource details.
requestId

string

ID of the request associated with the error.

ErrorResponseDetails

Object

The error response details.

Name Type Description
errorCode

string

A specific identifier that provides information about an error condition, allowing for standardized communication between our service and its users.
message

string

A human readable representation of the error.
relatedResource

ErrorRelatedResource

The error related resource details.

Workspace

Object

A workspace object.

Name Type Description
apiEndpoint

string (uri)

HTTP URL that represents the API endpoint specific to the workspace. This endpoint value is returned when the user enables preferWorkspaceSpecificEndpoints. It allows for API access over private links.
capacityId

string (uuid)

The ID of the capacity the workspace is assigned to.
description

string

The workspace description.
displayName

string

The workspace display name.
domainId

string (uuid)

The ID of the domain the workspace is assigned to.
id

string (uuid)

The workspace ID.
type

WorkspaceType

The workspace type.

WorkspaceType

Enumeration

A workspace type. Additional workspace types may be added over time.

Value Description
Personal

My folder or My workspace used to manage user items.
Workspace

Workspace used to manage the Fabric items.
AdminWorkspace

Admin monitoring workspace. Contains admin reports such as the audit report and the usage and adoption report.