---
title: "Create workspace for tenant"
method: POST
path: "/integrator/workspaces"
tags: ["integrator-workspaces"]
---

# Create workspace for tenant

`POST /integrator/workspaces`

Create a new workspace for the authenticated integrator.

Each workspace represents a tenant in KB2B.

## Request body

- CreateWorkspaceRequest — Request to create a workspace for a tenant.
  - `name` string, required — Workspace name
  - `slug` string, required — URL-friendly slug

## Response `201`

Workspace created

- WorkspaceInfo — Workspace information.
  - `id` string, uuid, required
  - `name` string, required
  - `slug` string, required
  - `integrator_id` string, uuid, required
  - `is_active` boolean, required
  - `created_at` string, date-time, required
  - `quotas` WorkspaceQuotas — Quota limits for a workspace.
    - `max_pots` integer — Max POTs per workspace
    - `max_documents_per_pot` integer — Max documents per POT
    - `max_storage_bytes` integer — Max cumulative storage in bytes (default 50MB)
    - `max_monthly_tokens` integer, nullable — Monthly token limit (prompt + completion). None = unlimited.
    - `bonus_tokens` integer — Add-on tokens for current billing period (top-ups).
  - `usage` WorkspaceUsage — Current usage counters for a workspace.
    - `pots_count` integer
    - `documents_count` integer
    - `storage_bytes` integer

## Other responses

- `409` — Workspace slug already exists
- `422` — Validation Error

---

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