Previous value: -"Patch-mode only: site-relative paths to remove from the pod. Files not in this list are kept. Reported back in `deletedFiles` listing only entries that actually existed. Combine with `files` to atomically rename in one call (write new path + delete old path). Rejected in mode:'replace' since replace already removes anything not in `files`."New value: +"Patch mode only: site-relative paths to remove; other files stay. Combine with `files` to rename in one call. Rejected in replace mode."

Previous value: -"If true, validate input + introspect what would change but don't write or delete. Returns the same shape with `dryRun: true` and `deletedFiles` showing what *would* be removed. Use this before any destructive call (replace mode, or patch with `delete`) to verify the diff."New value: +"Validate and preview without writing; deletedFiles lists what would be removed. Use it before replace mode or a patch with `delete`."

Previous value: -[
-  {
-    "items": {
-      "properties": {
-        "content": {
-          "type": "string"
-        },
-        "encoding": {
-          "description": "utf8 (default) treats content as a UTF-8 string written verbatim. base64 decodes content from base64 — required for binary files (images, fonts, PDFs); without it the literal base64 string lands on disk and the file is broken. gzip+base64 ships ~3–5× more raw text per tool call: gzip the bytes locally first, then base64-encode the gzip output. Server gunzips before writing.",
-          "enum": [
-            "utf8",
-            "base64",
-            "gzip+base64"
-          ],
-          "type": "string"
-        },
-        "path": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "path",
-        "content"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "additionalProperties": {
-      "type": "string"
-    },
-    "propertyNames": {
-      "type": "string"
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "description": "Array form; needed for binary files.",
+    "items": {
+      "properties": {
+        "content": {
+          "description": "File content: text, or base64 as set by encoding.",
+          "type": "string"
+        },
+        "encoding": {
+          "description": "utf8 (default): text written as is. base64: required for binary files (images, fonts, PDFs), otherwise the file is stored as broken text. gzip+base64: gzip locally, then base64; fits 3-5x more text per call.",
+          "enum": [
+            "utf8",
+            "base64",
+            "gzip+base64"
+          ],
+          "type": "string"
+        },
+        "path": {
+          "description": "Path relative to the site root, e.g. index.html or assets/app.js. Plain ASCII, no leading slash.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "path",
+        "content"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "additionalProperties": {
+      "type": "string"
+    },
+    "description": "Map form: path to UTF-8 text.",
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  }
+]

Previous value: -"Files to write. Array form `[{path, content, encoding?}]` (preferred) supports binary via encoding:'base64'; map form `{path: content}` is utf8-only. <= 500 MB total. Optional when `delete` is provided in patch mode for delete-only deploys."New value: +"Files to write: `[{path, content, encoding?}]` (preferred) or a `{path: content}` map. <= 500 MB total. May be omitted for a delete-only call in patch mode."

Previous value: -"patch (default): write only the listed files; everything else stays. replace: delete all existing files and write only the listed ones. Use replace only when you genuinely want to throw away the rest of the site."New value: +"patch (default): write only the listed files; everything else stays. replace: delete every existing file and write only the listed ones."

Previous value: -"Site name (preferred)."New value: +"Site name as shown by list_sites, e.g. my-portfolio. Provide name or siteId."

Previous value: -"Site id (alternative to name)."New value: +"Site id from list_sites or get_site. Use instead of name."

Previous value: -"Result of the Netlify-style _headers sync: ship a _headers file in the site root to override default response headers (e.g. Permissions-Policy). Site-wide (/*) rules only."New value: +"Result of syncing the _headers file in the site root (site-wide /* response headers)."

Previous value: -"Files removed by this call. For patch mode this is the entries from `delete` that actually existed; for replace mode it's every pre-existing file not in `files`."New value: +"Files removed by this call: the `delete` entries that existed (patch), or every file not in `files` (replace)."

Previous value: -"True if this was a dry-run; nothing was written or deleted."New value: +"True on a dry run: nothing was written or deleted."

Added value: +{
+  "description": "Dashboard page where the user manages this site (domains, versions, settings). Omitted on dry runs.",
+  "type": "string"
+}

Previous value: -"Surfaced issues that did not block the deploy (e.g. DOTFILE_PUBLIC, leaked-secret patterns)."New value: +"Non-blocking findings (e.g. DOTFILE_PUBLIC, leaked-secret patterns)."

Removed value: -{
-  "description": "Server-assigned request correlation id. Quote it when contacting support.",
-  "type": "string"
-}

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "applied": {
+          "type": "number"
+        },
+        "changed": {
+          "type": "boolean"
+        },
+        "warnings": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "applied",
+        "changed",
+        "warnings"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Result of the Netlify-style _headers sync: ship a _headers file in the site root to override default response headers (e.g. Permissions-Policy). Site-wide (/*) rules only."
+}

Added value: +{
+  "description": "Server-assigned request correlation id. Quote it when contacting support.",
+  "type": "string"
+}