Sites

Update site

Changed on Oct 11, 2026

Replaces the multi-file site bundle (ZIP archive or individual files with paths). Requires the owner token returned at creation. Password is preserved as-is (not changed in this operation).

put/api/sites/{ns}/{id}

Request

Base URL: https://brewpage.app
URL: https://brewpage.app/api/sites/{ns}/{id}
Auth: API key in header X-Owner-Token

Path parameters

nsstring required

idstring required

Query parameters

tagsstring

Comma-separated tags

ttlstring

TTL in integer days (1-30); accepts 15, 15d, 15 day or 15 days, case-insensitive. Omission preserves the original expiry; updates do not renew it.

entrystring

Entry file path override (default: auto-detect index.html)

Headers

X-Owner-Tokenstring required

Owner token returned at creation. Required for update

User-Agentstring

Response

Site updated

idstring required

Unique 10-character alphanumeric site ID

namespacestring required

linkstring required

Primary URL returned for browser viewing and sharing

ownerLinkstring required

API URL for programmatic access (info, update, delete)

entryFilestring required

Entry HTML file resolved from the upload (e.g. index.html)

fileCountinteger required

totalSizeBytesinteger required

expiresAtstring date-time required

tagsstring[] required

visibilityNoticestring

Human-readable explanation of link access and conditional public-discovery eligibility. Unlisted links are not secret; password protection applies when configured. No guarantee of listing, ranking or search-engine indexing.

managementLinkstring nullable required

routingCohortstring required

deliveryModestring nullable required

requestedDeliveryModestring nullable required

effectiveDeliveryModestring nullable required

deliveryModeMatchedboolean nullable required

accessstring required

modeLockedboolean required

hostingVersioninteger nullable required

Changes

Oct 11, 202610dfacb13d63 Revision changes
- breaking
  request body became required
- breaking
  removed the media type application/json from the request body
- breaking
  added the pattern ^\s*(?:\d+\s*(?:[dD]|[dD][aA][yY][sS]?)?)?\s*$ to the query request parameter ttl
- breaking
  removed the media type */* for the response with the status
- breaking
  removed the media type */* for the response with the status
- breaking
  removed the media type */* for the response with the status
- breaking
  removed the media type */* for the response with the status
- breaking
  removed the media type */* for the response with the status
- breaking
  removed the media type */* for the response with the status
- warning
  deleted the query request parameter files
- warning
  deleted the query request parameter paths
- info
  api operation id update removed and replaced with republishSite
- info
  the endpoint scheme security OwnerToken was added to the API
- info
  added the media type multipart/form-data to the request body
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
Oct 7, 2026753c148646ce Revision changes
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  added subschema #2 to the response property oneOf list for the response status
- breaking
  added subschema #2 to the response property oneOf list for the response status
- breaking
  added subschema #2 to the response property oneOf list for the response status
- breaking
  added subschema #2 to the response property oneOf list for the response status
- breaking
  added subschema #2 to the response property oneOf list for the response status
- breaking
  added subschema #2 to the response property oneOf list for the response status
- breaking
  the response's property type changed from object to no type for status
- breaking
  the response's property type changed from object to no type for status
- breaking
  the response's property type changed from object to no type for status
- breaking
  the response's property type changed from object to no type for status
- breaking
  the response's property type changed from object to no type for status
- breaking
  the response's property type changed from object to no type for status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status

Operation history