SMBBETA

Create a Workspace

Last updated Oct 10, 2026View as MarkdownAgent setup / MCP
POST
/v1/workspaces

Creates an active team Workspace and owner membership atomically for the authenticated user. Reusing Idempotency-Key with the same name returns the original Workspace; reusing it with a different name is rejected.

Authorization

userBearer
AuthorizationBearer <token>

A signed-in, non-anonymous SMB user's access token. Workspace API keys cannot bootstrap a new Workspace.

In: header

Header Parameters

Idempotency-Key*string

A caller-generated key. Keep it stable when retrying the same creation request.

Length8 <= length <= 200

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/workspaces" \  -H "Idempotency-Key: stringst" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "workspace": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "workspace_type": "team",    "resource_type": "workspace",    "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",    "status": "active",    "metadata": {},    "created_at": "2019-08-24T14:15:22Z"  },  "owner_membership": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",    "role": "owner",    "status": "active",    "permissions": {},    "joined_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z"  },  "access": {    "access_level": "full_access"  },  "request_id": "string",  "original_request_id": "string",  "idempotent_replay": true}