put_space

[Workspaces]

Create or replace workspace metadata by stable key. Use absent for creation or the current revision for replacement. Retain requestId for retries.

Parameters

Name	Type	Required	Description
definition	json	Yes	Workspace metadata: title (required) and an optional IANA defaultTimeZone. An omitted time zone becomes UTC, including on replacement.
ifRevision	string	Yes	Use "absent" to create, or the current revision to replace. A stale revision returns revision_conflict.
key	string	Yes	Stable workspace key, unique in the store.
requestId	string	Yes	A fresh UUID for each change. After an ambiguous response, retry with the same requestId and identical arguments; a changed payload returns request_conflict.

Examples

Replace the sample IDs with values from your store. Use a fresh UUID for each requestId.

Create a workspace.

Arguments 
{
  "key": "research",
  "definition": {
    "title": "Research",
    "defaultTimeZone": "Europe/Madrid"
  },
  "ifRevision": "absent",
  "requestId": "88888888-8888-4888-8888-888888888888"
}

Full MCP request

Full MCP request 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "put_space",
    "arguments": {
      "key": "research",
      "definition": {
        "title": "Research",
        "defaultTimeZone": "Europe/Madrid"
      },
      "ifRevision": "absent",
      "requestId": "88888888-8888-4888-8888-888888888888"
    }
  }
}