changedInput schema / properties / confirm / description
Previous value: -"Required when the named site already exists. Pass exactly \"I-want-to-replace-all-files\" to acknowledge that every existing file will be deleted and replaced with this new fileset. Omit on first deploy of a new site. If you want to add or change files without removing the others, use update_site instead — it defaults to patch mode."New value: +"Required when the site already exists: exactly \"I-want-to-replace-all-files\", confirming that every existing file is deleted and replaced. Omit for a new site."
changedInput schema / properties / dryRun / description
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. Strongly recommended before any deploy_site against an existing site."New value: +"Validate and preview without writing; deletedFiles lists what would be removed. Recommended before replacing an existing site."
changedInput schema / properties / files / anyOf
Previous value: -[
- {
- "description": "Array of { path, content, encoding? } file entries. Use this form for binary files.",
- "items": {
- "properties": {
- "content": {
- "type": "string"
- },
- "encoding": {
- "description": "utf8 (default), base64 (binary files), or gzip+base64 (~3–5× more raw bytes per tool call: gzip locally, base64-encode the gzip output, server gunzips on receive).",
- "enum": [
- "utf8",
- "base64",
- "gzip+base64"
- ],
- "type": "string"
- },
- "path": {
- "type": "string"
- }
- },
- "required": [
- "path",
- "content"
- ],
- "type": "object"
- },
- "type": "array"
- },
- {
- "additionalProperties": {
- "type": "string"
- },
- "description": "Map of relative file path to UTF-8 content. Use the array form if you need binary support (images, fonts).",
- "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), base64 (binary files), or 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"
+ }
+]
changedOutput schema / properties / created / description
Previous value: -"True if the site was created by this call."New value: +"True if this call created the site."
changedOutput schema / properties / customHeaders / description
Previous value: -"Result of the Netlify-style _headers sync: include 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)."
changedOutput schema / properties / deletedFiles / description
Previous value: -"Files that existed before this call and were removed by it. Empty for brand-new sites."New value: +"Files that existed before this call and were removed by it. Empty for a new site."
changedOutput schema / properties / dryRun / description
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."
addedOutput schema / properties / manageUrl
Added value: +{
+ "description": "Dashboard page where the user manages this site (domains, versions, settings). Omitted on dry runs.",
+ "type": "string"
+}
changedOutput schema / properties / url / description
Previous value: -"Live URL of the deployed site."New value: +"Live URL of the site."
changedOutput schema / properties / warnings / description
Previous value: -"Surfaced issues that did not block the deploy. Common types: DOTFILE_PUBLIC (a .well-known/* file is served publicly, confirm intent), or secret-scanner findings (AWS Access Key, Stripe Key, JWT Token, etc.)."New value: +"Non-blocking findings: DOTFILE_PUBLIC (a public .well-known file) or detected secrets such as API keys or JWTs."
