# Create a workspace `POST /workspaces` **Required scope:** `workspaces:write` Most organisations use the one they already have; list them with GET /workspaces first rather than creating a second. ## Request body Content type: `application/json` (required) | Field | Type | Required | Description | |---|---|---|---| | `name` | string | **yes** | workspace name (required) | ## Responses | Status | Meaning | |---|---| | `200` | Success | | `400` | BadRequest | | `401` | Unauthorized | | `403` | Forbidden | | `429` | RateLimited | ## Example ```bash curl -X POST "https://backend.immut.io/api/v1/workspaces" \ -H "Authorization: Bearer $IMMUT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name":""}' ``` ## OpenAPI fragment ```json { "/workspaces": { "post": { "operationId": "postworkspaces", "summary": "Create a workspace. Most organisations use the one they already have; list them with GET /workspaces first rather than creating a second.", "description": "Create a workspace. Most organisations use the one they already have; list them with GET /workspaces first rather than creating a second.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "workspace name (required)" } }, "required": [ "name" ] } } } }, "responses": { "200": { "description": "Success" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "tags": [ "Workspaces" ], "x-required-scope": "workspaces:write" } } } ```