Skip to navigation
API ReferenceWorkspaces

✨ Create workspace

Label Studio Enterprise badge

This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise

Create a new workspace. Workspaces in Label Studio let you organize your projects and users into separate spaces. This is useful for managing different teams, departments, or projects within your organization. For more information, see the Workspaces documentation.

Authentication

AuthorizationToken

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example: 

curl https://label-studio-host/api/projects -H “Authorization: Token [your-token]”

Request

This endpoint expects an object.
titlestringRequired1-1000 characters
Workspace Name
colorstring or nullOptional<=16 characters
Color
descriptionstring or nullOptional
Workspace description
is_archivedbooleanOptional
Workspace is archived
is_personalbooleanOptional
Workspace is a personal user workspace

Response

created_byintegerRead-only
created_by_usermap from strings to any or nullRead-only

Return created_by user details when include_all_workspaces is enabled.

idintegerRead-only
interfaces_countinteger or nullRead-only
Saved interfaces in the workspace. A workspace with interfaces cannot be deleted.
membershipmap from strings to any or nullRead-only
projects_countinteger or nullRead-only
titlestring<=1000 characters
Workspace Name
colorstring or nullOptional<=16 characters
Color
descriptionstring or nullOptional
Workspace description
is_archivedbooleanOptional
Workspace is archived
is_personalbooleanOptional
Workspace is a personal user workspace