---
title: "Create a new workspace"
method: POST
path: "/v2/workspaces"
tags: ["Workspaces"]
---

# Create a new workspace

`POST /v2/workspaces`

Creates a workspace owned by the authenticated user. Available only on Standard, Pro, and Enterprise plans, up to the plan's maximum workspace count.

The name must be 1-32 characters (letters, numbers, space, hyphen, or underscore). Rate limited to 1 creation every 10s per user.

## Request body

- object
  - `name` string, required

## Response `200`

Workspace created.

- object
  - `status` 'success', required
  - `response` object, required
    - `id` string, required
    - `name` string, required

## Other responses

- `400` — The name failed validation, the workspace quota was reached, or the workspace could not be created.
- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `403` — The active plan does not include workspaces. Upgrade to Standard, Pro, or Enterprise.
- `413` — The request body is larger than the maximum allowed size (100MB).
- `429` — The endpoint enforces its own rate limit and the caller hit the cooldown.
- `500` — An unexpected error occurred while processing the request.

---

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