Skip to main content

create_workspace

Creates a new workspace to organize your design tokens and tokensets.

Tool Schema

{
  "name": "create_workspace",
  "description": "Create a new workspace",
  "inputSchema": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255,
        "description": "The name of the workspace"
      },
      "description": {
        "type": "string",
        "description": "Optional description of the workspace"
      }
    },
    "required": ["name"]
  }
}

Parameters

ParameterTypeRequiredDescription
namestringYesThe name of the workspace (1-255 characters)
descriptionstringNoOptional description of the workspace

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "New Design System",
  "description": "Workspace for the new product design system",
  "created_at": "2025-01-20T15:30:00Z",
  "updated_at": "2025-01-20T15:30:00Z"
}

Example Usage in Claude

Create a Simple Workspace

You: Create a new workspace called "Mobile App Design System"

Claude: I'll create a new workspace for your mobile app design system.

Workspace created successfully:
- **Name**: Mobile App Design System
- **ID**: 550e8400-e29b-41d4-a716-446655440000
- **Description**: (none)

Create Workspace with Description

You: Create a workspace called "Marketing Website" with description "Design tokens for the marketing website redesign"

Claude: I'll create the marketing website workspace with your description.

Workspace created successfully:
- **Name**: Marketing Website
- **ID**: 550e8400-e29b-41d4-a716-446655440001
- **Description**: Design tokens for the marketing website redesign

Common Use Cases

1. New Product Launch

You: I need to create a workspace for our new mobile app design system

2. Project Organization

You: Create separate workspaces for web, mobile, and marketing designs

3. Client Work

You: Set up a workspace for the Acme Corp design system

Notes

  • Workspace names must be unique within your account
  • Workspaces can contain multiple tokensets
  • You can create as many workspaces as needed for different projects or clients
  • Workspaces help organize related design tokens logically

See Also