Republish site
republish_siteRepublish (full-replace) an existing multi-file BrewPage site in place at the SAME URL/ID. Requires owner token. The uploaded bundle becomes the complete new file set — files absent from it are removed, new files added, matching files overwritten. Single-page: entryContent. Multi-page: files (array of {path, content}). Optional entry overrides the default index.html. Republishing preserves existing expiry. Old publications (made before 5 October 2026) are read-only: 409 OLD_PUBLICATION_READ_ONLY with createUrl to publish anew. Default limits (current values: GET /api/limits): a request is at most 25 MB; a site at most 200 files, 5 MB per file and 20 MB in total; each path at most 380 characters. System files (.DS_Store, __MACOSX/ and similar) are skipped and never count; files with an unsupported extension or a too-long path are skipped and listed in notices. Entry: entry, else root index.html, else the shallowest HTML file. Errors: 400 = a site limit exceeded (the message names it), invalid path or no HTML file; 413 = request over 25 MB, too many files and form fields, or a file name/path too long; 422 = no servable file left.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Site ID | |
| tags | No | Optional tags (replaces the site's existing tags) | |
| entry | No | Entry file path, default index.html | |
| files | No | Multi-file site: array of `{path, content}`. Mutually exclusive with `entryContent`. | |
| ttlDays | No | Ignored: republishing keeps the existing expiry; a supplied value comes back as a ttl-ignored notice. | |
| namespace | Yes | Site namespace | |
| ownerToken | No | Owner token from create. Default: BREWPAGE_OWNER_TOKEN. | |
| entryContent | No | HTML content for a single-page site (entry file). Mutually exclusive with `files`. |