Create a Workspace
POST
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.
userBearerheader
AuthorizationBearer <token>A signed-in, non-anonymous SMB user's access token. Workspace API keys cannot bootstrap a new Workspace.
Idempotency-Key*stringA caller-generated key. Keep it stable when retrying the same creation request.
Length
8 <= length <= 200application/json- body
name*NameThe 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
\SLength
1 <= length <= 80An identical request was replayed idempotently.
application/json- response
workspace*owner_membership*access*request_id*smb_v0_operations_get_business_request.__local.OpaqueIdLength
1 <= length <= 128original_request_id?smb_v0_operations_get_business_request.__local.OpaqueIdLength
1 <= length <= 128idempotent_replay*smb_v0_operations_create_list_request.__local.properties.body.__schema16curl -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}