culvii workspace create
Create a new workspace in the active tenant.
Synopsis
culvii workspace create --name <name> --slug <slug> [--env <env>]
Description
Creates a new workspace in the active tenant. Requires an OAuth session.
culvii dev also calls this internally to auto-provision a dev-{user-id} workspace on first run (named from the first 12 characters of your user ID, not your tenant). If the slug already exists, the existing workspace is returned - creation is idempotent.
Flags
| Flag | Required | Description |
|---|---|---|
--name | ✓ | Display name. Free text. |
--slug | ✓ | URL-safe identifier. Must match ^[a-z0-9][a-z0-9-]{0,62}$. Unique within the tenant. |
--env | - | Target environment. Defaults to active context. |
Examples
culvii workspace create --name "Payments" --slug payments
# → ✓ Workspace created successfully.
# → ID: uuid
# → Slug: payments
Error behaviour
| Condition | Message | Exit |
|---|---|---|
| Invalid slug format | 400 from server | 1 |
| Not authenticated | "Run culvii login first." | 1 |
| Network drops mid-request | "Error: Network or unexpected error: <message>." Nothing is created - rerun the command. | 1 |