✨ Create workspace | API Reference

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.

<Card href="https://humansignal.com/goenterprise"> <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/> <p style="margin-top: 10px; font-size: 14px;"> This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise) </p> </Card> 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](https://docs.humansignal.com/workspaces).

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_userstringRead-only

idintegerRead-only

membershipstringRead-only

projects_countinteger or nullRead-only

titlestring<=1000 characters

Workspace Name

colorstring or null<=16 characters

Color

descriptionstring or null

Workspace description

is_archivedboolean

Workspace is archived

is_personalboolean

Workspace is a personal user workspace

$	curl -X POST http://localhost:8000/api/workspaces/ \
>	-H "Authorization: Token <api_key>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"title": "Marketing Team Workspace"
>	}'

1	{
2	"created_by": 42,
3	"created_by_user": "jane.doe",
4	"id": 101,
5	"membership": "admin",
6	"projects_count": 5,
7	"title": "Marketing Team Workspace",
8	"color": "#4A90E2",
9	"description": "Workspace for the marketing team to manage campaigns and projects.",
10	"is_archived": false,
11	"is_personal": false
12	}