Just Publish

Previous value: -"Email to associate with the site. Captured unverified at first deploy; verification only required later for custom domains and recovery."New value: +"Email address for the site. A link is sent to it to confirm the address; it is also used for recovery and service messages."

Previous value: -"Returned ONLY on first create. Save it — it's the only way to update this site."New value: +"Returned ONLY on first create. Save it - it's the only way to update this site."

Previous value: -"Whether the site's owner email is verified right now. New sites are always false."New value: +"Whether the site's owner email is verified right now. False on a new site unless this address has been verified before."

Previous value: -"The site's slug / id — pass back to update it later."New value: +"The site's slug / id - pass back to update it later."

Previous value: -"Always 'utf-8' — only text files are inlined."New value: +"Always 'utf-8' - only text files are inlined."

Previous value: -"true if some requested file contents were omitted for size — request specific paths to read them."New value: +"true if some requested file contents were omitted for size - request specific paths to read them."

Previous value: -"The site's current version — pass as expected_version to update_site_file to avoid clobbering."New value: +"The site's current version - pass as expected_version to update_site_file to avoid clobbering."

Previous value: -nullNew value: +{
+  "properties": {
+    "created": {
+      "description": "true if this call created a new site; false if it updated an existing one.",
+      "type": "boolean"
+    },
+    "dashboard_url": {
+      "description": "Deep link to this site in the owner's dashboard.",
+      "type": "string"
+    },
+    "edit_token": {
+      "description": "Returned ONLY on first create. Save it — it's the only way to update this site.",
+      "type": "string"
+    },
+    "email_masked": {
+      "description": "The owner email, masked for display (e.g. 'a***@example.com').",
+      "type": "string"
+    },
+    "email_verified": {
+      "description": "Whether the site's owner email is verified right now. New sites are always false.",
+      "type": "boolean"
+    },
+    "files_uploaded": {
+      "description": "Number of files written in this deploy.",
+      "type": "integer"
+    },
+    "site_id": {
+      "description": "The site's slug / id — pass back to update it later.",
+      "type": "string"
+    },
+    "total_bytes": {
+      "description": "Total size of the site in bytes after this deploy.",
+      "type": "integer"
+    },
+    "url": {
+      "description": "The live URL of the published site.",
+      "type": "string"
+    },
+    "verify_required": {
+      "description": "true when the owner still needs to verify their email (keys on !email_verified).",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "url",
+    "site_id",
+    "created",
+    "email_verified",
+    "files_uploaded",
+    "total_bytes",
+    "email_masked",
+    "verify_required",
+    "dashboard_url"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "properties": {
+    "files": {
+      "description": "Inlined contents of the requested text files (default: all text files, capped for size).",
+      "items": {
+        "properties": {
+          "content": {
+            "description": "Full text content of the file.",
+            "type": "string"
+          },
+          "encoding": {
+            "description": "Always 'utf-8' — only text files are inlined.",
+            "enum": [
+              "utf-8"
+            ],
+            "type": "string"
+          },
+          "path": {
+            "description": "Path of this file under the site root.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "path",
+          "content",
+          "encoding"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "manifest": {
+      "description": "Every file on the site (always complete, regardless of which contents were inlined).",
+      "items": {
+        "properties": {
+          "content_type": {
+            "description": "Stored content-type, e.g. 'text/html'.",
+            "type": "string"
+          },
+          "is_text": {
+            "description": "Whether the file is a text type eligible to have its content inlined.",
+            "type": "boolean"
+          },
+          "path": {
+            "description": "Path under the site root, e.g. 'index.html'.",
+            "type": "string"
+          },
+          "sha256": {
+            "description": "Hex sha256 of the file bytes; null if not recorded for this file.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "size_bytes": {
+            "description": "File size in bytes.",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "path",
+          "size_bytes",
+          "content_type",
+          "sha256",
+          "is_text"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "site_id": {
+      "description": "The site's slug / id.",
+      "type": "string"
+    },
+    "truncated": {
+      "description": "true if some requested file contents were omitted for size — request specific paths to read them.",
+      "type": "boolean"
+    },
+    "url": {
+      "description": "The live URL of the site.",
+      "type": "string"
+    },
+    "version": {
+      "description": "The site's current version — pass as expected_version to update_site_file to avoid clobbering.",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "site_id",
+    "version",
+    "url",
+    "manifest",
+    "files",
+    "truncated"
+  ],
+  "type": "object"
+}

Previous value: -nullNew value: +{
+  "properties": {
+    "files_total": {
+      "description": "Total number of files on the site after the merge.",
+      "type": "integer"
+    },
+    "files_written": {
+      "description": "Paths of the files written in this update. All other files were left untouched.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "site_id": {
+      "description": "The site's slug / id.",
+      "type": "string"
+    },
+    "url": {
+      "description": "The live URL of the site.",
+      "type": "string"
+    },
+    "version": {
+      "description": "The site's new version after the merge.",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "site_id",
+    "url",
+    "version",
+    "files_written",
+    "files_total"
+  ],
+  "type": "object"
+}