Previous value: -[
-  "describe",
-  "create-session",
-  "stream-upload",
-  "batch",
-  "chunk",
-  "stream",
-  "finalize",
-  "status",
-  "cancel",
-  "list-sessions",
-  "cancel-all",
-  "chunk-status",
-  "chunk-delete",
-  "web-import",
-  "web-list",
-  "web-cancel",
-  "web-status",
-  "limits",
-  "extensions",
-  "blob-info"
-]New value: +[
+  "describe",
+  "status",
+  "list-sessions",
+  "chunk-status",
+  "web-list",
+  "web-status",
+  "limits",
+  "extensions",
+  "blob-info"
+]

Removed value: -{
-  "description": "Blob ID from POST /blob — the **default source** for all file & binary uploads (no base64, no MCP size limit, up to 100 MB). Single-use.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Alias for blob_id (deprecated). Accepted on chunk/stream/stream-upload only.",
-  "type": "string"
-}

Removed value: -{
-  "description": "1-indexed chunk number.",
-  "maximum": 9007199254740991,
-  "minimum": 1,
-  "type": "integer"
-}

Removed value: -{
-  "description": "Chunk size in bytes (server picks default).",
-  "maximum": 9007199254740991,
-  "minimum": 1,
-  "type": "integer"
-}

Removed value: -{
-  "description": "**Text only** — stored verbatim UTF-8. This is for writing content you are composing **on the fly** directly through the MCP (a note, a generated report, a snippet you just produced) — NOT a fallback for uploading an existing file. Do NOT pass base64 here (use content_base64). One of content/content_base64/blob_id.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Base64-encoded **binary**, server-decoded. ⚠️ **LAST RESORT — expect FAILURE above a few MB** (~33% inflation + MCP transport cap). If POST /blob is unreachable that is almost always a CLIENT-SIDE FIREWALL/PROXY restriction, not a server limit — have the user allow /blob instead of falling back here. Use `blob_id` for any real file.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Alias for profile_id (either name works)",
-  "minLength": 1,
-  "type": "string"
-}

Removed value: -{
-  "description": "Alias for profile_type (either name works).",
-  "enum": [
-    "workspace",
-    "share",
-    "fileshare"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Client identifier echoed back (alphanumeric + hyphens).",
-  "maxLength": 150,
-  "minLength": 1,
-  "type": "string"
-}

Previous value: -"When action='describe', narrow the output to ONE action's full params/notes (e.g. 'chunk'). Omit to get the compact action index."New value: +"With action='describe': return one action's params and notes instead of the action index."

Removed value: -{
-  "description": "File name. Optional when target_node_id is set (auto-resolved); pass to rename-on-replace.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Batch manifest (1..200 entries). Each: filename + one of blob_id/content/content_base64.",
-  "items": {
-    "properties": {
-      "blob_id": {
-        "description": "Blob ID from POST /blob. One of blob_id/content/content_base64.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "content": {
-        "description": "Inline **text** content (verbatim UTF-8; ≤4 MB). Do NOT pass base64 here.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "content_base64": {
-        "description": "Inline **binary** as base64 (server-decoded; ≤4 MB).",
-        "minLength": 1,
-        "type": "string"
-      },
-      "filename": {
-        "description": "File name (1-255 characters). An over-length name is a hard ERROR — the platform no longer truncates.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "hash": {
-        "description": "Hex hash digest. Both hash and hash_algo must be supplied together.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "hash_algo": {
-        "description": "Hash algorithm. Pair with hash.",
-        "enum": [
-          "md5",
-          "sha1",
-          "sha256",
-          "sha384"
-        ],
-        "type": "string"
-      },
-      "relative_path": {
-        "description": "Sub-folder path under folder_id (trailing slash auto-added; no leading slash, no '.' or '..').",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "filename"
-    ],
-    "type": "object"
-  },
-  "maxItems": 200,
-  "minItems": 1,
-  "type": "array"
-}

Removed value: -{
-  "description": "Total file size in bytes.",
-  "maximum": 9007199254740991,
-  "minimum": 1,
-  "type": "integer"
-}

Removed value: -{
-  "description": "Target folder OpaqueId or \"root\". Omit for instance root.",
-  "type": "string"
-}

Removed value: -{
-  "description": "File hash for verification.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Hash algorithm (e.g. 'sha256').",
-  "type": "string"
-}

Removed value: -{
-  "description": "Compare-and-swap base for an overwrite. Enforced on EVERY update target — workspace, share and File Share. Pass the version id your edit was based on; record it on create-session/stream-upload (finalize does NOT read it). On a stale base the session ends assembly_failed with CONFLICT_VERSION_MISMATCH:<id> — rebase and retry. Omitting it is last-write-wins. See action=describe.",
-  "minLength": 1,
-  "type": "string"
-}

Removed value: -{
-  "description": "Compute SHA-256 client-side for entries without a hash (default true when omitted).",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "Stream-body byte ceiling — aborts mid-transfer if exceeded. Always overestimate; omit to use plan limit. Stream sessions only.",
-  "maximum": 9007199254740991,
-  "minimum": 1,
-  "type": "integer"
-}

Removed value: -{
-  "description": "Parent folder OpaqueId or \"root\". On create-session, stream-upload, and web-import, folder_id is accepted as an alias (either name works).",
-  "type": "string"
-}

Previous value: -"File Share link password (profile_type=fileshare only). Forwarded ONLY as the x-ve-password header on every upload phase — never in a URL/log. Supply when the target share is password-protected."New value: +"File Share link password (profile_type=fileshare only). Sent only as the x-ve-password header on each call, never in a URL/log; needed when the target share is password-protected."

Removed value: -{
-  "description": "Polymorphic context ID (pair with profile_type=workspace|share|fileshare). Typed aliases let you omit profile_type: workspace_id (⇒ workspace) / share_id (⇒ share); also context_id / instance_id. Target workspace/share ID, or the File Share id for a fileshare write-back. fileshare has NO typed alias — pass profile_type=fileshare explicitly.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Target type: workspace | share | fileshare (alias: context_type). Use `fileshare` ONLY for content write-back to a File Share's bound file (requires target_node_id = the bound node id from `fileshare details`; create-style new-file flows are rejected for fileshare).",
-  "enum": [
-    "workspace",
-    "share",
-    "fileshare"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Alias for profile_id when the profile is a share — implies profile_type=share (so profile_type may be omitted).",
-  "type": "string"
-}

Removed value: -{
-  "description": "Stream mode — size optional, single POST, auto-finalizes.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "Overwrite this specific node (preserves node_id; new version). When set, parent_node_id is ignored and filename is optional (auto-resolved). Must be a file node. REQUIRED for profile_type=fileshare write-back — set it to the File Share's bound node id (from `fileshare details` → fileshare.file.id).",
-  "minLength": 1,
-  "type": "string"
-}

Removed value: -{
-  "description": "Source URL to import from.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Alias for profile_id when the profile is a workspace — implies profile_type=workspace (so profile_type may be omitted).",
-  "type": "string"
-}

Previous value: -"**Text only** — stored verbatim UTF-8. Do NOT pass base64 here (use content_base64). One of content/content_base64/blob_id."New value: +"**Text only** — stored verbatim UTF-8. This is for writing content you are composing **on the fly** directly through the MCP (a note, a generated report, a snippet you just produced) — NOT a fallback for uploading an existing file. Do NOT pass base64 here (use content_base64). One of content/content_base64/blob_id."

Previous value: -"Base64-encoded **binary**, server-decoded (whitespace stripped). **Fallback only** — capped a few MB by the MCP transport. Prefer `blob_id` (POST /blob) for any file/binary; use this only when your client cannot make the POST /blob call."New value: +"Base64-encoded **binary**, server-decoded. ⚠️ **LAST RESORT — expect FAILURE above a few MB** (~33% inflation + MCP transport cap). If POST /blob is unreachable that is almost always a CLIENT-SIDE FIREWALL/PROXY restriction, not a server limit — have the user allow /blob instead of falling back here. Use `blob_id` for any real file."

Previous value: -"File Share write-back compare-and-swap (profile_type=fileshare only). Pass the version id your edit was based on (from fileshare details / versions-list). If the file advanced, NOTHING is written — the session ends assembly_failed with CONFLICT_VERSION_MISMATCH:<id>; rebase and retry. Omitting it is last-write-wins. See action=describe."New value: +"Compare-and-swap base for an overwrite. Enforced on EVERY update target — workspace, share and File Share. Pass the version id your edit was based on; record it on create-session/stream-upload (finalize does NOT read it). On a stale base the session ends assembly_failed with CONFLICT_VERSION_MISMATCH:<id> — rebase and retry. Omitting it is last-write-wins. See action=describe."

Added value: +1

Previous value: -"Long-poll duration ms (0 = return immediately)."New value: +"Long-poll wait in SECONDS, 1-590 (NOT milliseconds; 0/omitted returns immediately). The server holds the connection until the upload reaches a terminal status. Sending a millisecond value here would hold for minutes and blow past the tool-call timeout."

Previous value: -9007199254740991New value: +590

Previous value: -"Base64-encoded **binary**, server-decoded (whitespace stripped). **Fallback only** — capped a few MB by the MCP transport. Prefer `blob_id` (POST /blob) for…"New value: +"Base64-encoded **binary**, server-decoded (whitespace stripped). **Fallback only** — capped a few MB by the MCP transport. Prefer `blob_id` (POST /blob) for any file/binary; use this only when your client cannot make the POST /blob call."

Previous value: -"File name (1-255 chars; server truncates >100 chars while preserving extension)."New value: +"File name (1-255 characters). An over-length name is a hard ERROR — the platform no longer truncates."

Removed value: -255

Removed value: -8192

Previous value: -"File Share write-back compare-and-swap (profile_type=fileshare only). Pass the version id the edit was based on (from `fileshare details` / `fileshare…"New value: +"File Share write-back compare-and-swap (profile_type=fileshare only). Pass the version id your edit was based on (from fileshare details / versions-list). If the file advanced, NOTHING is written — the session ends assembly_failed with CONFLICT_VERSION_MISMATCH:<id>; rebase and retry. Omitting it is last-write-wins. See action=describe."

Previous value: -"File Share link password (profile_type=fileshare only). Forwarded ONLY as the x-ve-password header on every upload phase — never in a URL/log. Supply when the…"New value: +"File Share link password (profile_type=fileshare only). Forwarded ONLY as the x-ve-password header on every upload phase — never in a URL/log. Supply when the target share is password-protected."

Previous value: -"Polymorphic context ID (pair with profile_type=workspace|share|fileshare). Typed aliases let you omit profile_type: workspace_id (⇒ workspace) / share_id (⇒…"New value: +"Polymorphic context ID (pair with profile_type=workspace|share|fileshare). Typed aliases let you omit profile_type: workspace_id (⇒ workspace) / share_id (⇒ share); also context_id / instance_id. Target workspace/share ID, or the File Share id for a fileshare write-back. fileshare has NO typed alias — pass profile_type=fileshare explicitly."

Previous value: -"Target type: workspace | share | fileshare (alias: context_type). Use `fileshare` ONLY for content write-back to a File Share's bound file (requires…"New value: +"Target type: workspace | share | fileshare (alias: context_type). Use `fileshare` ONLY for content write-back to a File Share's bound file (requires target_node_id = the bound node id from `fileshare details`; create-style new-file flows are rejected for fileshare)."

Previous value: -"Overwrite this specific node (preserves node_id; new version). When set, parent_node_id is ignored and filename is optional (auto-resolved). Must be a file…"New value: +"Overwrite this specific node (preserves node_id; new version). When set, parent_node_id is ignored and filename is optional (auto-resolved). Must be a file node. REQUIRED for profile_type=fileshare write-back — set it to the File Share's bound node id (from `fileshare details` → fileshare.file.id)."

Previous value: -"Blob ID from POST /blob. Preferred for binary/large files. Single-use."New value: +"Blob ID from POST /blob — the **default source** for all file & binary uploads (no base64, no MCP size limit, up to 100 MB). Single-use."

Previous value: -"Base64-encoded **binary** — server decodes before writing. Whitespace stripped. Practical cap a few MB; use blob_id for larger."New value: +"Base64-encoded **binary**, server-decoded (whitespace stripped). **Fallback only** — capped a few MB by the MCP transport. Prefer `blob_id` (POST /blob) for…"

Previous value: -"Polymorphic context ID. Pair with profile_type=workspace|share|org, or =fileshare for File Share write-back. Use workspace_id instead when only workspaces are…"New value: +"Polymorphic context ID (pair with profile_type=workspace|share|fileshare). Typed aliases let you omit profile_type: workspace_id (⇒ workspace) / share_id (⇒…"

Added value: +{
+  "description": "Alias for profile_id when the profile is a share — implies profile_type=share (so profile_type may be omitted).",
+  "type": "string"
+}

Added value: +{
+  "description": "Alias for profile_id when the profile is a workspace — implies profile_type=workspace (so profile_type may be omitted).",
+  "type": "string"
+}

Previous value: -"Target workspace/share ID."New value: +"Target workspace/share ID — also the profile_id alias for upload flows; profile_id is canonical."

Added value: +1

Previous value: -"Alias for blob_id (deprecated)."New value: +"Alias for blob_id (deprecated). Accepted on chunk/stream/stream-upload only."

Previous value: -"Alias for profile_type (either name works)"New value: +"Alias for profile_type (either name works)."

Previous value: -[
-  "workspace",
-  "share"
-]New value: +[
+  "workspace",
+  "share",
+  "fileshare"
+]

Added value: +{
+  "description": "When action='describe', narrow the output to ONE action's full params/notes (e.g. 'chunk'). Omit to get the compact action index.",
+  "type": "string"
+}

Added value: +{
+  "description": "File Share write-back compare-and-swap (profile_type=fileshare only). Pass the version id the edit was based on (from `fileshare details` / `fileshare…",
+  "type": "string"
+}

Added value: +{
+  "description": "File Share link password (profile_type=fileshare only). Forwarded ONLY as the x-ve-password header on every upload phase — never in a URL/log. Supply when the…",
+  "type": "string"
+}

Previous value: -"Polymorphic context ID. Pair with profile_type=workspace|share|org. Use workspace_id instead when only workspaces are valid. Target workspace/share ID (alias: context_id)."New value: +"Polymorphic context ID. Pair with profile_type=workspace|share|org, or =fileshare for File Share write-back. Use workspace_id instead when only workspaces are…"

Previous value: -"Target type: workspace or share (alias: context_type)."New value: +"Target type: workspace | share | fileshare (alias: context_type). Use `fileshare` ONLY for content write-back to a File Share's bound file (requires…"

Previous value: -[
-  "workspace",
-  "share"
-]New value: +[
+  "workspace",
+  "share",
+  "fileshare"
+]

Previous value: -"Overwrite this specific node (preserves node_id; new version). When set, parent_node_id is ignored and filename is optional (auto-resolved). Must be a file node."New value: +"Overwrite this specific node (preserves node_id; new version). When set, parent_node_id is ignored and filename is optional (auto-resolved). Must be a file…"

Removed value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": 1,
-    "type": "integer"
-  },
-  {
-    "pattern": "^-?\\d+$",
-    "type": "string"
-  }
-]

Added value: +9007199254740991

Added value: +1

Added value: +"integer"

Removed value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": 1,
-    "type": "integer"
-  },
-  {
-    "pattern": "^-?\\d+$",
-    "type": "string"
-  }
-]

Added value: +9007199254740991

Added value: +1

Added value: +"integer"

Removed value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": 1,
-    "type": "integer"
-  },
-  {
-    "pattern": "^-?\\d+$",
-    "type": "string"
-  }
-]

Added value: +9007199254740991

Added value: +1

Added value: +"integer"

Removed value: -"^[A-Za-z0-9-]+$"

Removed value: -"^[0-9a-fA-F]+$"

Removed value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": 1,
-    "type": "integer"
-  },
-  {
-    "pattern": "^-?\\d+$",
-    "type": "string"
-  }
-]

Added value: +9007199254740991

Added value: +1

Added value: +"integer"

Removed value: -true

Previous value: -"Compute SHA-256 client-side for entries without a hash (default true)."New value: +"Compute SHA-256 client-side for entries without a hash (default true when omitted)."

Removed value: -[
-  {
-    "maximum": 100,
-    "minimum": 1,
-    "type": "integer"
-  },
-  {
-    "pattern": "^-?\\d+$",
-    "type": "string"
-  }
-]

Added value: +100

Added value: +1

Added value: +"integer"

Removed value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": 1,
-    "type": "integer"
-  },
-  {
-    "pattern": "^-?\\d+$",
-    "type": "string"
-  }
-]

Added value: +9007199254740991

Added value: +1

Added value: +"integer"

Removed value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": 0,
-    "type": "integer"
-  },
-  {
-    "pattern": "^-?\\d+$",
-    "type": "string"
-  }
-]

Added value: +9007199254740991

Added value: +0

Added value: +"integer"

Removed value: -"uri"

Removed value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": 0,
-    "type": "integer"
-  },
-  {
-    "pattern": "^-?\\d+$",
-    "type": "string"
-  }
-]

Added value: +9007199254740991

Added value: +0

Added value: +"integer"

Previous value: -"Operation to perform"New value: +"Operation. Use 'describe' for full action reference."

Previous value: -[
-  "create-session",
-  "stream-upload",
-  "batch",
-  "chunk",
-  "stream",
-  "finalize",
-  "status",
-  "cancel",
-  "list-sessions",
-  "cancel-all",
-  "chunk-status",
-  "chunk-delete",
-  "web-import",
-  "web-list",
-  "web-cancel",
-  "web-status",
-  "limits",
-  "extensions",
-  "blob-info"
-]New value: +[
+  "describe",
+  "create-session",
+  "stream-upload",
+  "batch",
+  "chunk",
+  "stream",
+  "finalize",
+  "status",
+  "cancel",
+  "list-sessions",
+  "cancel-all",
+  "chunk-status",
+  "chunk-delete",
+  "web-import",
+  "web-list",
+  "web-cancel",
+  "web-status",
+  "limits",
+  "extensions",
+  "blob-info"
+]

Previous value: -"Context action: create or update (used by: limits)"New value: +"Context: create or update."

Previous value: -"Blob ID from POST /blob response. The standard method for uploading file data — avoids base64 overhead and MCP transport limits. Consumed (deleted) after use. (used by: chunk, stream, stream-upload as one of content/content_base64/blob_id)"New value: +"Blob ID from POST /blob. Preferred for binary/large files. Single-use."

Previous value: -"Alias for blob_id (deprecated — use blob_id instead)"New value: +"Alias for blob_id (deprecated)."

Added value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": 1,
+    "type": "integer"
+  },
+  {
+    "pattern": "^-?\\d+$",
+    "type": "string"
+  }
+]

Previous value: -"Specific chunk number to retrieve (omit for all) (used by: chunk-status)"New value: +"Specific chunk number (omit for all)."

Removed value: -9007199254740991

Removed value: -1

Removed value: -"integer"

Added value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": 1,
+    "type": "integer"
+  },
+  {
+    "pattern": "^-?\\d+$",
+    "type": "string"
+  }
+]

Previous value: -"1-indexed chunk number (required for: chunk, chunk-delete)"New value: +"1-indexed chunk number."

Removed value: -9007199254740991

Removed value: -1

Removed value: -"integer"

Added value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": 1,
+    "type": "integer"
+  },
+  {
+    "pattern": "^-?\\d+$",
+    "type": "string"
+  }
+]

Previous value: -"Chunk size in bytes (optional, server picks default) (used by: create-session)"New value: +"Chunk size in bytes (server picks default)."

Removed value: -0

Removed value: -9007199254740991

Removed value: -"integer"

Previous value: -"Small **text** content (code snippets, JSON, plain text). Stored verbatim as UTF-8 bytes — do NOT pass base64 here, it will be saved as a base64 string and corrupt the file. For binary data inside MCP transport limits, use `content_base64`. For larger files, use POST /blob + `blob_id`. (used by: chunk, stream, stream-upload as one of content/content_base64/blob_id)"New value: +"**Text only** — stored verbatim UTF-8. Do NOT pass base64 here (use content_base64). One of content/content_base64/blob_id."

Previous value: -"Small **binary** content as a base64-encoded string — the server decodes it before writing. Useful for sandboxed agents that can produce base64 in JSON but cannot reach the POST /blob sidecar. Whitespace and newlines are stripped automatically. Practical cap is bounded by the MCP transport message size (a few MB); use POST /blob + `blob_id` for files larger than that. (used by: chunk, stream, stream-upload as one of content/content_base64/blob_id; batch uses the per-entry `files[].content_base64` field instead)"New value: +"Base64-encoded **binary** — server decodes before writing. Whitespace stripped. Practical cap a few MB; use blob_id for larger."

Previous value: -"Optional client identifier echoed back in the response (1-150 chars, alphanumeric and hyphens only). (used by: batch)"New value: +"Client identifier echoed back (alphanumeric + hyphens)."

Previous value: -"File ID for update context (required if action_context=update) (used by: limits)"New value: +"File ID for update context."

Previous value: -"Name of the file to upload. Required for create-session and stream-upload unless target_node_id is provided (in which case it's optional — omit to keep the existing node's name, auto-resolved via a storage details lookup; pass to rename-on-replace). Optional for web-import."New value: +"File name. Optional when target_node_id is set (auto-resolved); pass to rename-on-replace."

Previous value: -"Manifest of files to upload in a single batch (1..200 entries). Each entry needs filename + exactly one of blob_id|content|content_base64. (required for: batch)"New value: +"Batch manifest (1..200 entries). Each: filename + one of blob_id/content/content_base64."

Previous value: -"Blob ID from POST /blob. Exactly one of blob_id|content|content_base64 per entry; empty strings rejected."New value: +"Blob ID from POST /blob. One of blob_id/content/content_base64."

Previous value: -"Inline **text** content for small files (stored verbatim as UTF-8 bytes — do NOT pass base64 here, use `content_base64` for binary). Exactly one of blob_id|content|content_base64 per entry; empty strings rejected (most plans reject zero-byte uploads server-side anyway). Resolved bytes must be ≤ 4 MB."New value: +"Inline **text** content (verbatim UTF-8; ≤4 MB). Do NOT pass base64 here."

Previous value: -"Inline **binary** content as a base64-encoded string — the server decodes it before writing. Useful for sandboxed agents that cannot reach POST /blob. Whitespace/newlines stripped automatically. Exactly one of blob_id|content|content_base64 per entry. Decoded bytes must be ≤ 4 MB."New value: +"Inline **binary** as base64 (server-decoded; ≤4 MB)."

Previous value: -"File name for this manifest entry (1-255 chars; the server truncates names over 100 chars while preserving the extension)."New value: +"File name (1-255 chars; server truncates >100 chars while preserving extension)."

Previous value: -"Hex hash digest (lowercase or uppercase, at least 1 char). Both hash and hash_algo must be provided together if supplied; caller-supplied digests are forwarded verbatim without local verification."New value: +"Hex hash digest. Both hash and hash_algo must be supplied together."

Previous value: -"Hash algorithm. Both hash and hash_algo must be provided together if supplied."New value: +"Hash algorithm. Pair with hash."

Previous value: -"Sub-folder path under folder_id (1-8192 UTF-8 chars). Trailing slash required — normalized if missing. Must not start with \"/\" or contain \".\" / \"..\" segments. Auto-created on upload if the sub-folder doesn't exist."New value: +"Sub-folder path under folder_id (trailing slash auto-added; no leading slash, no '.' or '..')."

Added value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": 1,
+    "type": "integer"
+  },
+  {
+    "pattern": "^-?\\d+$",
+    "type": "string"
+  }
+]

Previous value: -"Total file size in bytes (required for: create-session when stream=false; optional when stream=true)"New value: +"Total file size in bytes."

Removed value: -0

Removed value: -9007199254740991

Removed value: -"integer"

Previous value: -"Batch-level target folder OpaqueId or \"root\". All files land under this folder. Omit to upload to the root of the instance. (used by: batch)"New value: +"Target folder OpaqueId or \"root\". Omit for instance root."

Previous value: -"File hash for verification (used by: stream, stream-upload)"New value: +"File hash for verification."

Previous value: -"Hash algorithm (e.g. 'sha256') (used by: stream, stream-upload)"New value: +"Hash algorithm (e.g. 'sha256')."

Previous value: -"When true (default), SHA-256 is computed client-side for each entry that doesn't already carry hash/hash_algo. Server validates the digest and rejects truncated/corrupt transfers with a per-file error. Set false to skip hashing. (used by: batch)"New value: +"Compute SHA-256 client-side for entries without a hash (default true)."

Previous value: -"Target workspace/share ID (required if action_context=create) (used by: limits)"New value: +"Target workspace/share ID."

Added value: +[
+  {
+    "maximum": 100,
+    "minimum": 1,
+    "type": "integer"
+  },
+  {
+    "pattern": "^-?\\d+$",
+    "type": "string"
+  }
+]

Previous value: -"Max results (1-100, default 50) (used by: web-list)"New value: +"Max results (1-100, default 50)."

Removed value: -100

Removed value: -1

Removed value: -"integer"

Added value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": 1,
+    "type": "integer"
+  },
+  {
+    "pattern": "^-?\\d+$",
+    "type": "string"
+  }
+]

Previous value: -"Ceiling for the stream body in bytes. Upload fails mid-transfer if actual bytes exceed this value — always overestimate, never undershoot. There is no penalty for setting it too high. Safest default: omit this parameter and the server uses your plan's file-size limit. Note: streaming uploads via MCP are also bounded by the `POST /blob` sidecar (100 MB cap per blob); for larger files use the chunked flow instead, and call `upload` action `limits` first to confirm plan headroom. Applies to stream sessions only (create-session with stream=true, or any stream-upload call). (used by: create-session, stream-upload)"New value: +"Stream-body byte ceiling — aborts mid-transfer if exceeded. Always overestimate; omit to use plan limit. Stream sessions only."

Removed value: -0

Removed value: -9007199254740991

Removed value: -"integer"

Added value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": 0,
+    "type": "integer"
+  },
+  {
+    "pattern": "^-?\\d+$",
+    "type": "string"
+  }
+]

Previous value: -"Pagination offset (used by: web-list)"New value: +"Pagination offset."

Removed value: -9007199254740991

Removed value: -0

Removed value: -"integer"

Previous value: -"Organization ID for limit resolution (used by: limits)"New value: +"Org ID for limit resolution."

Previous value: -"Parent folder OpaqueId or \"root\" (required for: create-session, stream-upload, web-import)"New value: +"Parent folder OpaqueId or \"root\". On create-session, stream-upload, and web-import, folder_id is accepted as an alias (either name works)."

Previous value: -"Override billing plan to check (e.g. free, pro) (used by: extensions)"New value: +"Override billing plan to check (e.g. free, pro)."

Previous value: -"Target workspace/share profile ID (also accepted as context_id) (required for: create-session, stream-upload, web-import)"New value: +"Polymorphic context ID. Pair with profile_type=workspace|share|org. Use workspace_id instead when only workspaces are valid. Target workspace/share ID (alias: context_id)."

Previous value: -"Target type: workspace or share (also accepted as context_type) (required for: create-session, stream-upload, web-import)"New value: +"Target type: workspace or share (alias: context_type)."

Previous value: -"Filter by status (used by: web-list)"New value: +"Filter by status."

Previous value: -"Enable stream mode — size becomes optional, upload via single POST to /upload/{id}/stream/ instead of chunking. Auto-finalizes on completion. (used by: create-session)"New value: +"Stream mode — size optional, single POST, auto-finalizes."

Previous value: -"When provided, overwrite this specific node_id (creating a new version). Overrides filename+parent matching — use this when you need a deterministic overwrite target (e.g., the filename may have drifted or the file lives in a folder you don't want to re-resolve). Preserves node_id; version-list shows prior versions. Must reference an existing file node (not a folder). When set, the API uses action=update and file_id=target_node_id; parent_node_id is ignored and filename is optional (if omitted, the tool auto-resolves the node's current name from storage details; pass filename only when renaming). (used by: create-session, stream-upload)"New value: +"Overwrite this specific node (preserves node_id; new version). When set, parent_node_id is ignored and filename is optional (auto-resolved). Must be a file node."

Previous value: -"Upload session ID or web upload job ID (required for: chunk, stream, finalize, status, cancel, chunk-status, chunk-delete, web-cancel, web-status)"New value: +"Upload session ID or web upload job ID."

Previous value: -"Source URL to import from (required for: web-import)"New value: +"Source URL to import from."

Added value: +[
+  {
+    "maximum": 9007199254740991,
+    "minimum": 0,
+    "type": "integer"
+  },
+  {
+    "pattern": "^-?\\d+$",
+    "type": "string"
+  }
+]

Previous value: -"Long-poll duration in milliseconds (0 = return immediately). Server holds connection until status changes or wait expires. (used by: status)"New value: +"Long-poll duration ms (0 = return immediately)."

Removed value: -9007199254740991

Removed value: -0

Removed value: -"integer"

Previous value: -"Blob ID from POST /blob response. The standard method for uploading file data — avoids base64 overhead and MCP transport limits. Consumed (deleted) after use. (used by: chunk, stream, stream-upload as one of content/blob_id)"New value: +"Blob ID from POST /blob response. The standard method for uploading file data — avoids base64 overhead and MCP transport limits. Consumed (deleted) after use. (used by: chunk, stream, stream-upload as one of content/content_base64/blob_id)"

Previous value: -"Small text content for a chunk (code snippets, JSON, etc.). For larger text files, use POST /blob + blob_id instead. (used by: chunk, stream, stream-upload as one of content/blob_id)"New value: +"Small **text** content (code snippets, JSON, plain text). Stored verbatim as UTF-8 bytes — do NOT pass base64 here, it will be saved as a base64 string and corrupt the file. For binary data inside MCP transport limits, use `content_base64`. For larger files, use POST /blob + `blob_id`. (used by: chunk, stream, stream-upload as one of content/content_base64/blob_id)"

Added value: +{
+  "description": "Small **binary** content as a base64-encoded string — the server decodes it before writing. Useful for sandboxed agents that can produce base64 in JSON but cannot reach the POST /blob sidecar. Whitespace and newlines are stripped automatically. Practical cap is bounded by the MCP transport message size (a few MB); use POST /blob + `blob_id` for files larger than that. (used by: chunk, stream, stream-upload as one of content/content_base64/blob_id; batch uses the per-entry `files[].content_base64` field instead)",
+  "type": "string"
+}

Previous value: -"Manifest of files to upload in a single batch (1..200 entries). Each entry needs filename + exactly one of blob_id|content. (required for: batch)"New value: +"Manifest of files to upload in a single batch (1..200 entries). Each entry needs filename + exactly one of blob_id|content|content_base64. (required for: batch)"

Previous value: -"Blob ID from POST /blob. Exactly one of blob_id|content per entry; empty strings rejected."New value: +"Blob ID from POST /blob. Exactly one of blob_id|content|content_base64 per entry; empty strings rejected."

Previous value: -"Inline text content for small files. Exactly one of blob_id|content per entry; empty strings rejected (most plans reject zero-byte uploads server-side anyway). Resolved bytes must be ≤ 4 MB."New value: +"Inline **text** content for small files (stored verbatim as UTF-8 bytes — do NOT pass base64 here, use `content_base64` for binary). Exactly one of blob_id|content|content_base64 per entry; empty strings rejected (most plans reject zero-byte uploads server-side anyway). Resolved bytes must be ≤ 4 MB."

Added value: +{
+  "description": "Inline **binary** content as a base64-encoded string — the server decodes it before writing. Useful for sandboxed agents that cannot reach POST /blob. Whitespace/newlines stripped automatically. Exactly one of blob_id|content|content_base64 per entry. Decoded bytes must be ≤ 4 MB.",
+  "minLength": 1,
+  "type": "string"
+}

Previous value: -[
-  "create-session",
-  "stream-upload",
-  "chunk",
-  "stream",
-  "finalize",
-  "status",
-  "cancel",
-  "list-sessions",
-  "cancel-all",
-  "chunk-status",
-  "chunk-delete",
-  "web-import",
-  "web-list",
-  "web-cancel",
-  "web-status",
-  "limits",
-  "extensions",
-  "blob-info"
-]New value: +[
+  "create-session",
+  "stream-upload",
+  "batch",
+  "chunk",
+  "stream",
+  "finalize",
+  "status",
+  "cancel",
+  "list-sessions",
+  "cancel-all",
+  "chunk-status",
+  "chunk-delete",
+  "web-import",
+  "web-list",
+  "web-cancel",
+  "web-status",
+  "limits",
+  "extensions",
+  "blob-info"
+]

Added value: +{
+  "description": "Optional client identifier echoed back in the response (1-150 chars, alphanumeric and hyphens only). (used by: batch)",
+  "maxLength": 150,
+  "minLength": 1,
+  "pattern": "^[A-Za-z0-9-]+$",
+  "type": "string"
+}

Added value: +{
+  "description": "Manifest of files to upload in a single batch (1..200 entries). Each entry needs filename + exactly one of blob_id|content. (required for: batch)",
+  "items": {
+    "properties": {
+      "blob_id": {
+        "description": "Blob ID from POST /blob. Exactly one of blob_id|content per entry; empty strings rejected.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "content": {
+        "description": "Inline text content for small files. Exactly one of blob_id|content per entry; empty strings rejected (most plans reject zero-byte uploads server-side anyway). Resolved bytes must be ≤ 4 MB.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "filename": {
+        "description": "File name for this manifest entry (1-255 chars; the server truncates names over 100 chars while preserving the extension).",
+        "maxLength": 255,
+        "minLength": 1,
+        "type": "string"
+      },
+      "hash": {
+        "description": "Hex hash digest (lowercase or uppercase, at least 1 char). Both hash and hash_algo must be provided together if supplied; caller-supplied digests are forwarded verbatim without local verification.",
+        "minLength": 1,
+        "pattern": "^[0-9a-fA-F]+$",
+        "type": "string"
+      },
+      "hash_algo": {
+        "description": "Hash algorithm. Both hash and hash_algo must be provided together if supplied.",
+        "enum": [
+          "md5",
+          "sha1",
+          "sha256",
+          "sha384"
+        ],
+        "type": "string"
+      },
+      "relative_path": {
+        "description": "Sub-folder path under folder_id (1-8192 UTF-8 chars). Trailing slash required — normalized if missing. Must not start with \"/\" or contain \".\" / \"..\" segments. Auto-created on upload if the sub-folder doesn't exist.",
+        "maxLength": 8192,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename"
+    ],
+    "type": "object"
+  },
+  "maxItems": 200,
+  "minItems": 1,
+  "type": "array"
+}

Added value: +{
+  "description": "Batch-level target folder OpaqueId or \"root\". All files land under this folder. Omit to upload to the root of the instance. (used by: batch)",
+  "type": "string"
+}

Added value: +{
+  "default": true,
+  "description": "When true (default), SHA-256 is computed client-side for each entry that doesn't already carry hash/hash_algo. Server validates the digest and rejects truncated/corrupt transfers with a per-file error. Set false to skip hashing. (used by: batch)",
+  "type": "boolean"
+}

Previous value: -"Name of the file to upload (required for: create-session, stream-upload unless target_node_id is provided; optional for: web-import)"New value: +"Name of the file to upload. Required for create-session and stream-upload unless target_node_id is provided (in which case it's optional — omit to keep the existing node's name, auto-resolved via a storage details lookup; pass to rename-on-replace). Optional for web-import."

Previous value: -"When provided, overwrite this specific node_id (creating a new version). Overrides filename+parent matching — use this when you need a deterministic overwrite target (e.g., the filename may have drifted or the file lives in a folder you don't want to re-resolve). Preserves node_id; version-list shows prior versions. Must reference an existing file node (not a folder). When set, the API uses action=update and file_id=target_node_id; parent_node_id is ignored and filename is optional (server keeps the existing name unless you pass one). (used by: create-session, stream-upload)"New value: +"When provided, overwrite this specific node_id (creating a new version). Overrides filename+parent matching — use this when you need a deterministic overwrite target (e.g., the filename may have drifted or the file lives in a folder you don't want to re-resolve). Preserves node_id; version-list shows prior versions. Must reference an existing file node (not a folder). When set, the API uses action=update and file_id=target_node_id; parent_node_id is ignored and filename is optional (if omitted, the tool auto-resolves the node's current name from storage details; pass filename only when renaming). (used by: create-session, stream-upload)"

Added value: +1

Previous value: -[
-  "create-session",
-  "chunk",
-  "stream",
-  "finalize",
-  "status",
-  "cancel",
-  "list-sessions",
-  "cancel-all",
-  "chunk-status",
-  "chunk-delete",
-  "web-import",
-  "web-list",
-  "web-cancel",
-  "web-status",
-  "limits",
-  "extensions",
-  "blob-info"
-]New value: +[
+  "create-session",
+  "stream-upload",
+  "chunk",
+  "stream",
+  "finalize",
+  "status",
+  "cancel",
+  "list-sessions",
+  "cancel-all",
+  "chunk-status",
+  "chunk-delete",
+  "web-import",
+  "web-list",
+  "web-cancel",
+  "web-status",
+  "limits",
+  "extensions",
+  "blob-info"
+]

Previous value: -"Blob ID from POST /blob response. The standard method for uploading file data — avoids base64 overhead and MCP transport limits. Consumed (deleted) after use. (used by: chunk, stream as one of content/blob_id)"New value: +"Blob ID from POST /blob response. The standard method for uploading file data — avoids base64 overhead and MCP transport limits. Consumed (deleted) after use. (used by: chunk, stream, stream-upload as one of content/blob_id)"

Previous value: -"Small text content for a chunk (code snippets, JSON, etc.). For larger text files, use POST /blob + blob_id instead. (used by: chunk, stream as one of content/blob_id)"New value: +"Small text content for a chunk (code snippets, JSON, etc.). For larger text files, use POST /blob + blob_id instead. (used by: chunk, stream, stream-upload as one of content/blob_id)"

Previous value: -"Name of the file to upload (required for: create-session unless target_node_id is provided; optional for: web-import)"New value: +"Name of the file to upload (required for: create-session, stream-upload unless target_node_id is provided; optional for: web-import)"

Previous value: -"File hash for verification (used by: stream)"New value: +"File hash for verification (used by: stream, stream-upload)"

Previous value: -"Hash algorithm (e.g. 'sha256') (used by: stream)"New value: +"Hash algorithm (e.g. 'sha256') (used by: stream, stream-upload)"

Previous value: -"Maximum bytes the stream may contain. Defaults to plan file size limit if omitted. Only used when stream=true. (used by: create-session)"New value: +"Ceiling for the stream body in bytes. Upload fails mid-transfer if actual bytes exceed this value — always overestimate, never undershoot. There is no penalty for setting it too high. Safest default: omit this parameter and the server uses your plan's file-size limit. Note: streaming uploads via MCP are also bounded by the `POST /blob` sidecar (100 MB cap per blob); for larger files use the chunked flow instead, and call `upload` action `limits` first to confirm plan headroom. Applies to stream sessions only (create-session with stream=true, or any stream-upload call). (used by: create-session, stream-upload)"

Previous value: -"Parent folder OpaqueId or \"root\" (required for: create-session, web-import)"New value: +"Parent folder OpaqueId or \"root\" (required for: create-session, stream-upload, web-import)"

Previous value: -"Target workspace/share profile ID (also accepted as context_id) (required for: create-session, web-import)"New value: +"Target workspace/share profile ID (also accepted as context_id) (required for: create-session, stream-upload, web-import)"

Previous value: -"Target type: workspace or share (also accepted as context_type) (required for: create-session, web-import)"New value: +"Target type: workspace or share (also accepted as context_type) (required for: create-session, stream-upload, web-import)"

Previous value: -"When provided, overwrite this specific node_id (creating a new version). Overrides filename+parent matching — use this when you need a deterministic overwrite target (e.g., the filename may have drifted or the file lives in a folder you don't want to re-resolve). Preserves node_id; version-list shows prior versions. Must reference an existing file node (not a folder). When set, the API uses action=update and file_id=target_node_id; parent_node_id is ignored and filename is optional (server keeps the existing name unless you pass one). (used by: create-session)"New value: +"When provided, overwrite this specific node_id (creating a new version). Overrides filename+parent matching — use this when you need a deterministic overwrite target (e.g., the filename may have drifted or the file lives in a folder you don't want to re-resolve). Preserves node_id; version-list shows prior versions. Must reference an existing file node (not a folder). When set, the API uses action=update and file_id=target_node_id; parent_node_id is ignored and filename is optional (server keeps the existing name unless you pass one). (used by: create-session, stream-upload)"