Apply a batch of file changes

Add, replace, and delete several files in ONE atomic commit: either every
change lands or none does. Send each new or replacement file as a file
part whose filename is its path inside the site (e.g. assets/app.js), and
each removal as a delete part containing the path.

The entry file can be replaced but never removed; a request that would
leave the page without it returns 409. Per-file and total size limits
depend on the caller's plan and are reported by the GET above; read them
from there rather than assuming the ZIP upload's limits.

An HTML page grows into a site. Committing a change that leaves a
kind: html page holding MORE than one file promotes it to kind: site in
the same transaction, and the response reports becameSite: true. The
promotion is one-way and happens IN PLACE: the page id, slug, public URL and
entry path are all unchanged, so no link ever breaks and no redirect is
involved. Replacing the single file of an HTML page is an edit, not an
expansion, and leaves it a kind: html page.

A hosted site cannot offer display_mode: download, so a page carrying that
mode has it reset to preview_download by the same statement that promotes
it; the response then also reports displayModeReset: true. Both flags are
the commit's own account of what it did — treat them as the authority rather
than re-deriving the rule client-side.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params multipart/form-dataRequired

{ "success": true, "data": { "files": [ { "path": "assets/app.js", "sizeBytes": 88134, "contentType": "text/javascript; charset=utf-8", "isEntry": false } ], "fileCount": 12, "totalBytes": 1069547, "maxFiles": 200, "maxFileBytes": 26214400, "maxTotalBytes": 5368709120, "becameSite": false, "displayModeReset": false } }

Request

Responses