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

# Create a workspace

`POST /v2/workspaces`

## Request

- Base URL: `https://api.infolang.ai`
- URL: `https://api.infolang.ai/v2/workspaces`
- Auth: HTTP bearer

Dual-write: provisions in Kairos (source of truth) first, then Supabase metadata. A metadata failure after provisioning returns 502 `partial_write`.

## Request body

- object
  - `name` string, required
  - `plan` unknown

## Response `201`

Created; caller is Owner

- object
  - `workspace_id` string, required
  - `name` string, required
  - `plan` string, required
  - `created` string, required
  - `role` 'Owner' | 'Admin' | 'Member' | 'ReadOnly', required

## Other responses

- `401`: Missing or invalid session token
- `403`: Caller lacks a grant on the workspace, or role too low. Or `lane_not_supported` — an `il_live_`/`il_test_`/`il_oauth_` credential, though valid, was presented to a route that accepts the session lane only
- `422`: Invalid body
- `502`: partial_write — Kairos provisioned but metadata write failed

---

[API](https://skmtc.dev/infolang/apis/infolang-api.md) · [All operations](https://skmtc.dev/infolang/apis/infolang-api/llms.txt) · [OpenAPI document](https://skmtc.dev/infolang/apis/infolang-api/revisions/d04bf6de72c8?raw)