{
  "type": "object",
  "properties": {
    "files": {
      "type": "array",
      "description": "Files to publish. Must include an index.html at the root.",
      "items": {
        "type": "object",
        "required": [
          "path",
          "content"
        ],
        "properties": {
          "path": {
            "type": "string",
            "description": "Path under the site root, e.g. 'index.html', 'assets/logo.png'."
          },
          "content": {
            "type": "string",
            "description": "File body. Text by default; binary must be base64."
          },
          "encoding": {
            "type": "string",
            "enum": [
              "base64",
              "utf-8"
            ],
            "description": "Defaults to utf-8 for text extensions, base64 otherwise."
          }
        }
      },
      "minItems": 1
    },
    "email": {
      "type": "string",
      "description": "Email address for the site. A link is sent to it to confirm the address; it is also used for recovery and service messages."
    },
    "site_id": {
      "type": "string",
      "description": "Existing site id to update. Omit to create a new site."
    },
    "edit_token": {
      "type": "string",
      "description": "Edit token returned at create time. Required to update."
    }
  },
  "required": [
    "files",
    "email"
  ]
}

{
  "type": "object",
  "properties": {
    "site_id": {
      "type": "string",
      "description": "The site id returned at publish time."
    },
    "edit_token": {
      "type": "string",
      "description": "The edit token returned at publish time."
    },
    "paths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional. Specific file paths to return contents for (e.g. ['index.html','style.css']). Omit to get all text files. The manifest always lists every file regardless."
    }
  },
  "required": [
    "site_id",
    "edit_token"
  ]
}

{
  "type": "object",
  "properties": {
    "site_id": {
      "type": "string",
      "description": "The site id returned at publish time."
    },
    "edit_token": {
      "type": "string",
      "description": "The edit token returned at publish time."
    },
    "files": {
      "type": "array",
      "minItems": 1,
      "description": "The files to change. Only these are written; all other files on the site survive.",
      "items": {
        "type": "object",
        "required": [
          "path",
          "content"
        ],
        "properties": {
          "path": {
            "type": "string",
            "description": "Path under the site root, e.g. 'index.html'."
          },
          "content": {
            "type": "string",
            "description": "Full new file body. Text by default; binary must be base64."
          },
          "encoding": {
            "type": "string",
            "enum": [
              "base64",
              "utf-8"
            ],
            "description": "Defaults to utf-8 for text, base64 otherwise."
          }
        }
      }
    },
    "expected_version": {
      "type": "integer",
      "description": "Optional but recommended. The `version` you got from get_site_files. If the site has changed since, the update is rejected with a conflict so you can re-read and re-apply. Omit to force last-writer-wins."
    }
  },
  "required": [
    "site_id",
    "edit_token",
    "files"
  ]
}