Beta

Create a Workspace

Last updated Nov 19, 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
headerAuthorizationBearer <token>

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

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
  1. body
name*Name

The display name for the new Workspace. Length is measured on the submitted value in Unicode code points; leading and trailing whitespace is removed before storage.

Match\S
Length1 <= length <= 80

Response Body

An identical request was replayed idempotently.

application/json
  1. response
workspace*
owner_membership*
access*
request_id*smb_v0_operations_get_business_request.__local.OpaqueId
Length1 <= length <= 128
original_request_id?smb_v0_operations_get_business_request.__local.OpaqueId
Length1 <= length <= 128
idempotent_replay*smb_v0_operations_create_list_request.__local.properties.body.__schema16
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}