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

# Create a workspace

`POST /v1/workspaces`

Creates a new AI workspace. Only one free (base) workspace is allowed per user.
The workspace name must be unique.

## Request body

- CreateWorkspaceRequest
  - `name` string, required — Unique workspace name (lowercase, 3-50 chars). Cannot be "liara".
  - `plan` 'base' | 'standard' | 'pro', required — Workspace plan tier

## Response `200`

Workspace created

- CreateWorkspaceResponse
  - `workspace` object
    - `_id` string — Workspace ID

## Other responses

- `400` — Bad request
- `401` — Missing authentication
- `402` — Payment required - insufficient balance
- `403` — Forbidden - already have a free workspace
- `409` — Conflict - workspace name already exists
- `410` — Gone - plan not available

---

[API](https://skmtc.dev/liara-cloud/apis/ai-workspaces.md) · [All operations](https://skmtc.dev/liara-cloud/apis/ai-workspaces/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/liara-cloud/ai-workspaces/revisions/dca23912b278/schema)