---
title: "Create Workspace"
method: POST
path: "/v2/workspace:create"
tags: ["Workspaces"]
---

# Create Workspace

`POST /v2/workspace:create`

Create a new workspace.

## Request body

- WorkspaceCreate
  - `name` string, required — The unique workspace name, it must be a valid DNS label as it will be used in URLs.
  - `display_name` string, required — The human-readable name of the workspace.
  - `region` 'EU' | 'US'
  - `capabilities` WorkspaceCapabilities
    - `can_generate_variants` boolean

## Response `200`

Successful Response

- WorkspaceResponse
  - `errors` string[] — List of error messages associated with the resource.
  - `internal_error_details` string[] — List of internal error messages associated with the `errors` field.
  - `id` string, int64, required — The unique identifier of the resource
  - `created_at` string, date-time, required — The time at which the resource was created
  - `created_by` string, required — The ID of the user who created the resource
  - `updated_at` string, date-time, required — The time at which the resource was last updated
  - `updated_by` string, required — The ID of the user who last updated the resource
  - `name` string, required
  - `display_name` string, required
  - `state` 'PROVISIONING' | 'DELETING' | 'READY' | 'FAILED', required
  - `picture_file_id` string, int64, nullable, required
  - `capabilities` WorkspaceCapabilities, required
    - `can_generate_variants` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/cradle/apis/cradle-api.md) · [All operations](https://skmtc.dev/cradle/apis/cradle-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cradle/cradle-api/revisions/b0b5b6bfaed8/schema)