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

# Create a workspace

`POST /api/v3/workspaces`

⚠️ **ALPHA ENDPOINT** - This endpoint is in alpha and subject to breaking changes. Use with caution in production environments.

Create a new custom workspace in the authenticated user's company. Requires the company to have `allow_user_workspace_creation` enabled, unless the caller is a company or instance administrator (who may always create workspaces). Returns **403** if workspace creation is disabled for the company and the caller is not an administrator.

The creator is automatically added as OWNER.

## Request body

- StandardWorkspaceCreateV3Request — V3 Request serializer for creating a workspace in the user's company.
  - `name` string, required
  - `description` string

## Response `201`

Workspace created successfully

- StandardWorkspaceV3DetailsResponse — V3 Response serializer for company workspace creation and retrieval.
  - `id` integer, required
  - `name` string, required
  - `workspace_type` string, required
  - `document_upload_method` string, required
  - `description` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `files_count` integer, required
  - `user_role` union, required
    - 'owner' | 'editor' | 'viewer' — * `owner` - owner * `editor` - editor * `viewer` - viewer * `` -
    - ''
  - `used_storage` number, double, required
  - `summaries` WorkspaceSummary[], required
    - `language` string, required
    - `summary` string, required
  - `sync` WorkspaceSync, required
    - `datasource_type` string, required
    - `source_name` string, required
    - `last_status` string, required
    - `updated_at` string, date-time, nullable, required
    - `failed_files_count` integer, required
    - `next_import_date` string, date-time, nullable, required
    - `editable` boolean, required
    - `name` string, required
    - `instance_url` string, nullable, required
    - `tenant_id` string, required
    - `site_name` string, required
    - `client_id` string, required
    - `filter_criteria` unknown, required
  - `scoped_api_keys` WorkspaceScopedAPIKey[], required
    - `id` string, required
    - `name` string, required
    - `prefix` string, required
    - `role` string, required
    - `created_at` string, date-time, required
    - `created_by` string, required
    - `scope_type` 'workspace' | 'global', required — * `workspace` - workspace * `global` - global

## Other responses

- `400` — Bad Request - Invalid input parameters (empty name, name too long, unsupported fields, etc.)
- `401` — Unauthenticated - Missing or invalid API key/session cookie
- `403` — Unauthorized - Standard users of this company are not allowed to create workspaces

---

[API](https://skmtc.dev/lighton/apis/lighton-api.md) · [All operations](https://skmtc.dev/lighton/apis/lighton-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lighton/lighton-api/revisions/86c57e94ef15/schema)