<!--
  immut documentation, machine-readable.

  Everything in one file:  https://www.immut.io/llms-full.txt
    What immut is, which integration path to choose, authentication and scopes, and the COMPLETE
    API reference: every endpoint with parameters, responses and a runnable curl. Fetch this first
    if you intend to call the API.

  Index of all pages:      https://www.immut.io/llms.txt
  OpenAPI contract:        https://www.immut.io/docs/openapi.json
  This page as HTML:       https://www.immut.io/docs/mcp/create_workspace

  Any page on this site is available as raw markdown by appending .md to its URL.
-->


# create_workspace

**Create an immut workspace**

Create a new immut workspace (requires the workspaces:write scope). Succeeds only if the plan has a free workspace slot; otherwise returns an "upgrade to add a workspace" message (relay it to the user).

- Access: write
- Calls: `/api/v1/workspaces`

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `name` | string | **yes** |  |

## Tool contract

```json
{
  "name": "create_workspace",
  "title": "Create an immut workspace",
  "description": "Create a new immut workspace (requires the workspaces:write scope). Succeeds only if the plan has a free workspace slot; otherwise returns an \"upgrade to add a workspace\" message (relay it to the user).",
  "access": "write",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/workspaces",
  "arguments": {
    "name": {
      "type": "string",
      "required": true,
      "description": ""
    }
  }
}
```