Create Workspace

Create a new workspace owned by the current user.

Workspaces are the top-level container for all resources (workflows, voices, dictionary entries, members). Every resource is scoped to exactly one workspace via the X-Workspace-Id header on subsequent requests.

The authenticated user becomes the workspace owner and is automatically added as an admin member. An optional slug (1–50 characters, lowercase kebab-case) can be supplied for a human-readable workspace identifier; if omitted, one is auto-generated from name. Returns 409 if the slug is already taken, 422 if the slug format is invalid or uses a reserved word.

The number of workspaces a user may own is plan-gated. Attempting to exceed the limit returns 402.

Create a new workspace owned by the current user. Workspaces are the top-level container for all resources (workflows, voices, dictionary entries, members). Every resource is scoped to exactly one workspace via the `X-Workspace-Id` header on subsequent requests. The authenticated user becomes the workspace owner and is automatically added as an `admin` member. An optional `slug` (1–50 characters, lowercase kebab-case) can be supplied for a human-readable workspace identifier; if omitted, one is auto-generated from `name`. Returns 409 if the slug is already taken, 422 if the slug format is invalid or uses a reserved word. The number of workspaces a user may own is plan-gated. Attempting to exceed the limit returns 402.

Authentication

AuthorizationBearer

Clerk JWT token

Request

This endpoint expects an object.

namestringRequired1-200 characters

Human-readable workspace name (1–200 characters, non-blank).

slugstring or nullOptional<=512 characters

Optional URL-safe identifier (lowercase kebab-case, 1–50 characters). Auto-generated from name if omitted. Returns 409 if taken, 422 if invalid or reserved.

color_idxintegerOptionalDefaults to 0

Index into the workspace color palette (0–6).

Response

Successful Response

dataobject

metaobject

Errors

409

Conflict Error

422

Unprocessable Entity Error

Create a new workspace owned by the current user.

The number of workspaces a user may own is plan-gated. Attempting to exceed the limit returns 402.

$	curl -X POST https://api.onepin.ai/api/v1/workspaces \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Acme Marketing Team"
>	}'

1	{
2	"data": {
3	"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4	"name": "Acme Marketing Team",
5	"slug": "acme-marketing-team",
6	"color_idx": 3,
7	"created_by": "9b2d7f4e-8c3a-4f1a-9d2e-1a2b3c4d5e6f",
8	"created_at": "2024-01-15T09:30:00Z",
9	"updated_at": "2024-01-15T09:30:00Z",
10	"routing_price_sensitivity": 0.5,
11	"routing_llm_fit": false
12	},
13	"meta": {
14	"request_id": "7f9c2d3e-4b1a-4c2d-8e3f-5a6b7c8d9e0f",
15	"timestamp": "2024-01-15T09:30:00Z"
16	}
17	}